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~ About 
This Manual 


Organization 


This manual, fopCAD Syntax Reference describes the syntax and 
programing tools that make up the topCAD Programing Language. 
Refer to this manual for the syntax required to type commands 
from the keyboard, write macros, Create new drawing methods, or 
create user menus. 


The two other manuals in the topCAD documentation set are: 
topCAD installation which explains how to set up the topCAD 
application, insta! a plotter or a tablet; 


fopCAD User's Guide is divided into three volumes. Volume 1 
describes the topCAD desktop, pointers, files and tools. 
Volume 2 and Volume 3 describe the menu commands. 


It is assumed throughout this manual that you already know how 
to use your Macintosh. If you are new to Macintosh, please refer 
to your Macintosh owner’s guides. 


This manual is divided into the following chapters: 


Chapter 1, “Introduction,” describes the purpose and the syntactic 
rules of topCAD‘s programing language. 


Chapter 2, “Detailed Command Description,” describes the 
functions, syntax and use of topCAD’s commands in details. 


Chapter 3, “Programing Tools,” describes the programing facilities 
you may need in order to write macros, such as expressions, 
functions, variables, assignments and contro! statements in 
topCAD’s programing language. 


Chapter 4, “Macro Examples,” describes several! exampies, with a 
varying degree of complexity, of writing macros and the use of 
external procedures written in high-level programing languages 
such as C, Pascal or FORTRAN. 


The “Index” lists the commands in this manua! by keywords in 
alphabetic order. 
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What is This Command Description for? 

About Programing in topCAD 

How to Make and Use Compound Commands? 
About Command Syntax in General 


General Rules of Syntax 


Nw oN Ww & fb 


The Rules of Syntax Description 1 


In this manual you can find the functional and syntactic 
description of each basic topCAD command, followed by an 
example if necessary. 


In the syntactically correct form all topCAD commands can be used 


One by one: 


Type in the command window 


the keyword of the command; 

¢ other keyword(s), if any; 

* expression(s) and/or parameter value(s) necessary to 
execute the command; 

e ENTER. 


This is equivalent to command execution by the graphic tools 
(icons, menus) but 


* you can use all toepCAD commands and 
e you should know and apply the rules of syntax. 


in a string of commands: 


Edit a series of topCAD commands according to the syntactic 
rules. This string of commands is called “compound command" 
and provides a complex function according to the needs of 
your application environment. 
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What is This 


Command Description 
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for? 


About Programing 


in topCAD 


Chapter 1: Introduction 


Working with topCAD you will execute most commands with the 
graphic tools, icons and menus; consequently, you don't need to 
know the command syntax. You can execute most of the basic and 
user defined commands this way. 


But, as mentioned in topCAD User's Guide, topCAD provides the 
facility of creating its application-oriented version by defining user 
commands and macros. For their use the knowledge of the syntax 
of the commands and the syntactic rules of topCAD’s programing 
language is necessary. The two kinds of compound commands are 
similar enough, Both are assembled from basic commands of 
topCAD and previously defined compound commands. 


The purpose of their creation is to increase the efficiency of your 
work with topCAD. You will have some series of steps in your 
work that you would like to repeat several times. Using topCAD 
you can define "macros" (strings of topCAD commands) performing 
these arbitrary, complex, often used functions, executed as simply 
as a basic command. 


in this manual you will find 

° the functional description of all topCAD commands, 

e the syntactic description of all topCAD commands, 

* the description of al! programing facilities you need to create 
and use macros and user defined commands. 


Using topCAD’s programing language you can write compound 
commands, which may include: 

¢ arbitrary series of all basic topCAD commands, 

* any number of previously defined macros, 

e functions, 

* contro! structures and other facilities 


according to the programing rules described in chapter Programing 
Tools. 


Any compound command can be defined and used as 
* a user icon command or 

® a user menu command or 

* amacro. 


All these kinds of compound command are of similar structure but 
their use is different. 


How to Make and Use 


Compound Commands? 


ev can assign to a compound command 
a user defined tool option, e.g.: a new circle definition can be 
made an icon command 
by the Custom Tools command, 


® a user defined usericon 
by the Custom User Icons command 
(you can change any user icon and/or the command(s) 
assigned to it), 


* auser menu item 
by the Custom Menus command, 
thereafter it can be used as a user menu command; or 


e it can be defined as a macro 
by the New Macro command. 


It is advisable to define the compound commands performing 
frequently used operations as user menu or icon commands. 
Their use is simple and quick; however, their number is limited. 


The compound commands creating objects (symbol definitions, 
etc.) should be defined as macros, because the number of macros 
is unlimited. 


Custom commands may be composed by issuing 

e the Custom Menus, 

e the Custom Tools or 

¢ the Custom User icons command 

in ne File menu (see chapter The Menu Commands in the User's 
Guide). 
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Custom commands 


Custom Menus 
command 


Custom Tools 
command 


Custom User Icons 
command 


Macros 


To define 
a macro 


To use 
a macro 


Chapter 1}: introduction 


You can build up your function as a series of basic topCAD 
commands and previously defined macros, assign a name to it and 
put it into one of the three user menus. 


As mentioned in chapter The Menu Commands in the User's 
Guide, up to 93 user commands can be defined and used in the 
three user menus. 


You can design tool option icons and assign arbitrary sequences of 
commands and previously defined macros to them. 


You can create user iconbar commands by designing an icon and 
defining the string of commands assigned to the icon. 


-The new icon(s) will appear in the user iconbar and you can 


execute your self-made user icon commandis) simply by clicking 
them. 


Starting from this moment, this self-made function can be used as 
easily as any other topCAD menu command: you should open the 
appropriate user menu and choose the command. 


See the above commands in section The File Menu, chapter The 
Menu Commands in the User’s Guide. 


These are series of topCAD commands and earlier defined macros 
as well. However, they are executed not directly from a menu but 
by a special command (see below). There are three commands in 
Symbol menu to create, use and modify them. 


Give the New macro command. After giving a name you can 
assemble the macro from the basic topCAD commands and the 
existing macros. There is no limit to nesting macros. Having finished 
the macro definition, you can put it into the macro (default) or 
another foider. 


Give the Execute macro command. After selecting and opening the 
macro it will be executed. 


To edit 
a macro 


About 
Command Syntax 
in General 


Give the Open macro command. After selecting and opening the 
macro it can be edited. 


(See section The Symbol menu in chapter The Menu Commands in 
the User’s Guide for details). 


This description contains the instructions in the format it should be 
entered, In one command string there can be only one main 
command (object definition or object modification) and an arbitrary 
number of other commands. Other commands (subcommands) can 
be placed before or after the main command or inserted between 
any two syntactic elements, a subcommand can be also broken by 
a new subcommand. 


A string can contain a text. If there is no special character in the 
text (like brackets or quotation marks) then it is not necessary to 
use delimiters. In other case the text must appear within quotation 
marks. If the program waits for a text and you want to give a 
keyword, then the keyword must be preceded by a siash '/’. 


If the text does not contain prompts then topCAD will use the 
standard prompts. You can redefine a prompt. The new prompt 
must appear within single quotation marks (‘new prompt’). The 
“'#' “ means the standard prompt. 


For example: 
/REPEAT ‘Number of copies' /DUPLICATE SELECTION 


The menu definition text file can be created by the user, giving a 
very high level flexibility for creating application tailored menus. 


Each command has its individual prompt text which immediately 
appears in the message tine when the program recognizes the 
keyword. This keyword prompt informs the user about the 
necessary parameters or qualifier keywords. 
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Chapter 1: 


introduction 


The slash "" preceding a word instructs topCAD to interpret the 
following word as a keyword. 


Eats stash before a keyword is not obligatory but useful, because 
it is easier to read the list of a Compound command with a slash 
preceding the keywords, 

* using it you can issue a command even when topCAD is 
waiting for a text; e.g. during the execution of a /text command. 


A semicolon {;) is equivalent to the /ENTER command. 
E.g: the  /circle cpoint 100 100 200 200 /ENTER 

and the /circle cpoint 100 100 200 200; 
command lines have exactly the same effect: both draw a circle with 
the centre point (100; 100) passing through the point (200; 200) 
and quit the command. 


The syntactic elements of the command lines should be separated 
by one or more space *" or comma “,” characters. 
E.g.:  /circle 140 230; 
‘circle 140,230; 
‘circle 140, 230 enter 
all these commands have the same effect. 


The arithmetical and logical expressions should be given in brackets 
od Ga 
E.g.:  (a+2°b) 

(i< 128) 


An expression may contain any number of spaces. 
E.g.: the (a +2* b) and 

the (Gi < 128) 
expressions are equivalent to the above ones. 


You should give an ENTER to quit the “cyclic” commands (see 
section Terminating Commands, chapter Commands in Genera! in 
the User’s Guide), since they restart after execution. 
E.g.: as a result of the 

/circle 140 230 
command, topCAD draws a circie with the centrepoint at (140) 
(230) and prompts for the centrepoint of the next circle. 


Having received the 

/circle 140 230 /ENTER or the 

/circle 140 230; 
command, topCAD draws the circle, quits the command and tries 
to execute the next command (if any). 


The following syntactic elements must be given between delimiters: 


e user defined prompts between '' characters 
(if you wish to use a different prompt from that provided by 
topCAD). 
E.g.: ‘specify the direction:' 


« Text between "" characters. 
E.g.: "This is a text" 


e £&xpressions between () characters. 
E.g.: (13 + .3*var1/c) 


A variable reference following 


* the /use command needs no delimiter. 
E.g.: fuse var2 


® any variable definition (except the /vtext command) needs no 
delimiter. 
E.g.:  /vint var2 876 
The variable var2 will have the value of 876. 


e a text variable definition needs no delimiter for the variable 
name, but needs the "" delimiters for the value. 
E.g.:  /vtext varS "This is a text" 
The variable var5 will have the value of "This is a text". 
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10. 


a 


Numerical values can be given between parentheses ( ) but it is not 
obligatory. 
E.g.: Both forms (125) and 125 are correct. 


There is no difference between the upper/lower case characters in 

keywords, variable names, symbol names and filenames. 

E.g.: the variables named aBC, ABC or abc are the same, the 
{circle and the /CIRCLE keywords are the same. 


In text the upper/lower case characters are different. 
E.g.: Define a Preferred text: 
/ATEXT “Abcde" 
Locate it: 
/TEXT 100 150; 
The string is located keeping the upper/lower case character 
of the Jetters. 


Uses of the “#" character in macros: 


¢ Comment: 
A "#" can be placed anywhere in a command line; the part of 
the text between the # and the end of the line will be 
considered as a comment and will not be interpreted. 
Consequently, if the first character in a line is a #, the whole line 
will be treated as a comment. 


E.g.:  /circle 130 140; #This is a command drawing a circle of 
#the Preferred radius 
The circle will be drawn and the comment reminds you 
of the function of the command. 


¢ Standard prompt: 
Entering ‘#' following the keyword of a command leads to the 
standard prompt of the command appearing in the command 
window. 


© Using files in macros: 

Defining a variable, it is possible to choose its value from a file. 

E.g.:  /vint var3 ‘#Dfilenums' 
You will see a dialog box displaying the numbers in the 
file named "Filenums". The value you select wiil be 
assigned to the variable “var3". 

See section Variable definition using dialog commands in 

Chapter 3 Programing Tools. 
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13. 


14. 


15. 


File-, symbol- and variable names: 
The name must start with a letter, followed by arbitrary characters. 


e filename: max. 120 characters 
(this is the maximal length of the total file definition including 
volume and/or folder), 

¢ symbol name: max. 50 characters, 

¢ variable name: max 12 characters. 

Wildcards in filenames and symbol names: 


%: any one character, 
*: any number of characters following the position of this asterisk. 


The length of command lines is unlimited. 


indexes of array elements should be given between | ] characters. 
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valint 
valfloat 
coord 
length 
angle 
text 


file 


symb 


Val 


tran 
prim 
select 
num 


set 
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The Rules of Syntax Description 


The indicated item is optional, it can be omitted. 

One of the listed elements must be selected. 

The indicated item can be repeated any number of times (or omitted). 
The program expects an integer type value. 

The program expects a floating-point type value. 

The program expects a pair of coordinates. 

The program expects a length value. 

The program expects an angle value. 

The program expects text. 


The program expects text which includes the specification of a file (its length shou!d 
not exceed one row). 


The program expects text which contains a symbol name (no longer than 48 
characters written in one row; it can include wildcards such as asterisks and 
question marks). 


The program expects text which contains a variable name (no longer than 20 
characters written in one row; the first character is alphabetic, the others are 
alphanumeric). in most cases the name can be followed by indexes {if the variable is 
an array) and a qualifier. 

The program expects a transformation. 

The program expects the selection of a single object. 

The program expects the selection of a group of objects. 

The program expects a single arithmetic expression. 

The program expects numerical expressions, the keyword NO followed by a 
numerical expression or a pair of numerical expressions separated by an underline 


or the keyword ALL. These together define the set of natural numbers in the range 
Osc 206. 
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133 
133 
139 
142 
145 
147 
155 
155 
161 


NEW 


QUIT 


Control Commands 


{ YES | NO} 


topCAD returns to the initial state: 

e clears the drawing window (deletes all objects in the current 
drawing) and 

e sets the default nonstandard (297*229.935 mm) sheet size. 


The deleted objects can not be revoked by the UNDO command. 
The command needs a confirmation. tf the answer is NO, it has no 
effect. 


E.g.:  /NEW; 
topCAD prompts for confirmation. 
Entering YES, the command is executed. 
Entering NO, the command is cancelled. 


/NEW YES; 
topCAD executes the command. 


{YES | NO} 


Quits topCAD. 
The command needs a confirmation. 
If the answer is NO, it has no effect. 


E.g.:  /QUIT; 
topCAD prompts for confirmation. 
Entering YES, the command is executed. 
Entering NO, the command is cancelled. 


/QUIT YES; 
topCAD executes the command. 
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COMPRESS 


EDIT EFILE 


WAIT 


{YES | NO} 


Compresses the data structures: clears the undo possibilities 
(normally used before a SAVE command). 

The command needs a confirmation. 

If the answer is NO, it has no effect. 


E.g.:  /COMPRESS; 
topCAD prompts for confirmation. 
Entering YES, the command is executed. 
Entering NO, the command is cancelled. 


{COMPRESS YES; 
topCAD executes the command. 


file 


Opens an edit window with a text editor to edit a text file named 


file. 
If the file already exists, it will be opened, if not, it will be created. 
After quitting the editor control is returned to topCAD. 


file: a file definition: 
[[volume} [:foldername] :] filename 


E.g.: /EDIT EFILE :Macro:myfile; 


the file named "myfile" will be opened or created in the 
Macro folder. 


sec 
The program waits for sec seconds. 
E.g..  /WAIT 17; 


Before the execution of the next command topCAD waits 
for 17 seconds. 
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ENTER 


ABORT 


CANCEL 


DUMMY 


Finishes the execution of the current activity and returns 
e to the nesting command, if any, or 
e tothe Command prompt. 


The ";" is equivalent to /ENTER. 


E.g.: the commands 
/CARC (123) (121) /ENTER 
/CARC (123) (121) ENTER 
/CARC 123 121; 
are equivalent. 


See section Terminating Commands in chapter Commands in 
weneral in User’s Guide for details. 


Terminates the Current activity without execution and returns 
* to the nesting command, if any, or 
* tothe Command prompt. 


See section Terminating Commands in chapter Commands in 
General in User’s Guide for details. 


Terminates all activities without execution and returns to the 
Command prompt. topCAD will wait for a new command. 


See section Terminating Commands in chapter Commands in 
Genera! in User’s Guide for details. 


it has no function in itself but, as it is a main command, any 
following change made to Preferred values or attributes will be 
TEMPORARY. 


it is very useful to start macros by this command. 
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ZOOM [IN] 


Display Commands 


coord! coord2 


The chosen window will fit the drawing window, retaining the 
original vertical/norizontal ratio. 

The center of the chosen window will be located at that of the 
drawing window. 


coord?: a corner of the chosen window, 
coord2: the opposite corner of the chosen window. 


— 


— 


original screen modified screen 


E.g.. /ZOOM IN (100) (100) (200) (200); 
The contents of the window defined by the (100) (100) and 
(200) (200) points as its corners will replace the contents of 
the drawing window. 


/ZOOM IN crtcenter bottomleft; 
The contents of the lower-left quarter of the current 
drawing window will be enlarged to full window size. 
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ZOOM OUT 


coord! coord2 


The contents of the eae window will be compressed into the 
chosen window, retaining the original vertical/horizonta! ratio. 
The center of the drawing window will be projected to that of the 
chosen window. 


coord!: one of the corners of the chosen window, 
coord2: the opposite corner of the chosen window. 


———— 


original screen modified screen 


E.g.: {ZOOM OUT (100) (100) (200) (200); 
The whole contents of the drawing window will be 
compressed into the window defined by the (100) (100) 
and (200) (200) points as its corners. 


{ZOOM OUT ertcenter bottomleft; 


The whole contents of the drawing window will be 
compressed into its lower-left quarter. 
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WINDOW — coord! coord2 


The chosen window completely fits the drawing window. 
The vertical/horizontal ratio will, in general, change! 


coord1: one of the corners of the chosen window, 
coord2: the opposite corner of the chosen window. 


gic 


Original screen modified screen 
E.g.: /WINDOW 100 100 180 200 


The contents of the window defined by the (100) (100), 
(180) (200) corners will fill the whole drawing window. 


SCALE num 


Entarges or reduces the drawing, retaining the position of its center. 
The vertical/horizontal ratio does not change. 


num: the scaling factor. 
num>1: the drawing is enlarged, 
num<1: the drawing is reduced. 


E.g.: /SCALE 2.7 
The drawing will be enlarged by 2.7. 
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AUTOSCALE 


PAN 


Scales the drawing so as to display all visible objects and optimally 
fill the drawing window. 
The vertical/norizontal ratio does not change. 


coord! coord2 

Shifts all the soa in the drawing window in such a way that the 
point coord1 of the command window is relocated to the point 
coord2. _ 

The verticai/horizontal ratio remains unchanged. 


coord1: _ the startpoint of the shift vector, 
coord2: the endpoint of the shift vector. 


original screen modified screen 


E.g.: /PAN 100 100 200 100 
The drawing will be shifted to the right by 100 mm. 
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RATIO 


PREVIOUS 


FOLLOWING 


REDRAW 


SHOW 


{num | ENTER } 


The vertical scaling will be multiplied by num, retaining the origina! 
center point (the vertical dimensions change, the horizontal 
dimensions remain unchanged), or the command restores the 
original dimensions of the drawing. 


num: the vertical scaling factor. 
num<i: the drawing is reduced vertically by num, 
num>1: the drawing is magnified vertically by num. 
ENTER: the vertical dimensions revert to the original values. 
E.g.:  /RATIO 2 
The drawing will be vertically enlarged by a factor of 2. 


/RATIO; 
The Y/X ratio will be reset to the original value. 


rum 


Displays the previous num'? window in the drawing window. The 
windows are stored in a 20 entries tong ring buffer. 


Aum 


Displays the next consecutive num'h window. The windows are 
stored in a 20 entries long ring buffer. 


Redraws the contents of the drawing window. 


select 


The program will only display the selected objects. The etfect of the 
command ceases if either implicit (definition of a new window) or 
explicit REDRAW is specified. 
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LAYER 


{ ACTIVE 1 ON | VISIBLE 1 OFF } [ONLY] set 

Sets the layer(s) specified by set to one of the following states: 
ACTIVE (Active): 

the new objects will be assigned to these layers (input layer), 
the objects assigned to these layers can be modified, 


the objects in these layers can be seen in the drawing window, 
the objects in these layers can be referenced; 


If the ONLY keyword is present, the currently ACTIVE layers which 

are not in the selection will be set to the state ON; 

ON (Modify Only): 

e the objects assigned to these layers can be modified (output 
layer), 

¢ the objects in these layers can be seen in the drawing window, 

e the objects in these layers can be referenced; 

If the ONLY keyword is present, the currently ON layers which are 

not in the selection will be set to the state VISIBLE; 

VISIBLE (Visible): 


* the objects in these layers can be seen in the drawing window, 
e the objects in these layers can be referenced. 


tf the ONLY keyword is present, the currently VISIBLE layers which 
are not in the selection will be set to the state OFF: 
OFF (Invisible): 


e the objects in these layers will disappear from the drawing 
window. 


if the ONLY keyword is present, the currently OFF layers which 
are nat in the selection wili be set to the state VISIBLE; 


set: the selected set of layers. 
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E.g.: /LAYER on 240,245,250; and press the ENTER key 
(fram the command window) or 


/LAYER on 240,245,250;: 

(from a macro): 

the layers 240, 245 and 250 will be ON, 
the other layers won't be affected. 


/LAYER active 240_245; 
the layers 240, 241, 242, 243, 244, 245 will be ACTIVE, 
the other layers won't be affected. 


/LAYER active /only 240_245; 

the layers 240, 241, 242, 243, 244, 245 will be ACTIVE 
and 

all the other ACTIVE layers will be ON. 

The other layers won't be affected. 


RGB {DEFAULT | < num red green blue > | ENTER } 
Assigns a red, green, blue vector to the num logical color number 
or resets the default logical color table vectors. The values may 
vary from 0 to 65535. 


DEFAULT: keyword to reset the values to default; 


num: the code of a color whose red green blue vector is to 
be redefined; 

red: value of the red component of the color in question; 

green: value of the green component of the color; 

blue: value of the blue component of the color. 


E.g.:  /RGB default; 
resets the red, green, blue vectors for all the 256 logical 
color numbers to the default values; 


/RGB default 77 10000 20000 30000; 

assigns default to all logical colors except the logical color 
number 77 which will be assigned the values red=10000, 
green=20000, biue=30000. 


/RGB 56 34000 20000 12345; 


assigns the red=34000, green=20000 and blue=12345 
values to the logical color number 56. 
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PEN 


num { PWIDTH length | set } 


Assigns a plotter pen width or a set of logical colors to the num 
physical plotter pen. 


num: a physical pen number; 

PWIDTH: keyword: the assigned value will be interpreted as a 
penwidth; 

length: value to be assigned as a penwidth; 

set: a set of logical colors. 


E.g.: /PEN 4 PWIDTH 3; 
The 4. pen will draw with a linewidth of 3. 


/PEN 4 3_12; 


The 4. pen will draw all objects with any color denoted by 
codes between 3 and 12. 
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GRID {ON | OFF | numt num2 num3 num4 numS length length2 } 


Displays, clears or defines grids. 
As many as four grids can be displayed at a time. 


ON: keyword to display the grid; 
OFF: keyword to clear the grid; 
num1: the serial number of the grid (1-4); 


num?2: the type of the grid: 


‘ aes ee ~ aati ta ety ee ae he + e a 
: : ‘ : \ 
‘ ‘ , ‘ t 
‘ oF : ' ‘ 
. ‘ 
‘ : Pes testa Ms eta + + ” 


s 
- ~ - ~ 


7-127 are the user defined line types; 


num3: the rarefication factor (every num3th grid tine will be 
displayed); 

num4: the logical color (0-255); 

nums: that maximum number of lines above which the grid is 


not drawn, since it would become too dense; 
length1: the grid spacing in x direction; 
length2: the grid spacing in y direction. 


The default values: 


num} num2 num3 num4 numS  lengihi length2 
1 6 1 1 50 1 } 
2 5 1 2 50 10 10 
3 4 1 3 50 100 100 
4 1 1 4 50 1000 1000 


E.g.:  /GRID 423 100 20 15 25; 

sets the parameters of grid 4 as foliows: 

- dotted line type (2), 

- every 3rd grid line will be displayed, 

- the grid lines will be drawn with the color of code 100, 
the horizonta! spacing between two neighbouring 
gridlines is 15, 

- the vertical spacing between two neighbouring gridlines 
is 25. 
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PLOT {A01!A1 1 A21A3 1 A4! AS | length! length? } {file | AOUT | 
BOUT } [scale] (X offset] [Y offset) [YES | NO] 


Outputs the current drawing,at the specified scale, to a plotter with 
the specified paper size [length1 and length2 or ISO standard 
(A0...A5)], into a file, or directly to a port. 


AO through AS: 
length1: 
length2: 

file: 


AOULUT: 
-BOUT: 
scale: 


X offset: 


Y offset: 


YES | NO: 


standard sheet sizes, 

the horizontal size of a nonstandard sheet, 

the vertical size of a nonstandard sheet, 

the name of the file you want to plot into (if you 
plot into a file instead of a plotter), 

the output will be sent to the modem pon, 

the output will be sent to the printer port, 
scale factor (1:scale), e.g.: 

the value 2 results in an output reduced by 2, 
the value 0.5 results in an output enlarged by 2. 
horizontal shift; the distance of the bottom-left 
corner of the smallest box around the drawing 
from the bottom-left corner of the drawing area 
on the sheet in x direction, 

vertical shift; the distance of the bottom-left 
corner of the smallest box around the drawing 
from the bottom-left corner of the drawing area 
on the sheet in y direction, 

rotation: 

YES: rotation into vertical position (portrait), 
NO: no rotation (landscape). 


E.g.: /PLOT 250 400 "gear '" .2 20 30 YES; 
makes a plot file of the current drawing in the file named 
"gear" with a sheet size of 250x400, enlarged 5 times. The 
rawing will be rotated (portrait) and offset by 20 
horizontally and by 30 vertically. The file will be put into the 
Plot folder. 


PRINT 


Makes an output to the printer set by the Chooser DA. 


E.g.:  /PRINT 


the current drawing is sent to the printer. 
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POINT 


DPOINT 


Object Creating Commands 


With the help of these commands a variety of objects can be 
created (e. g. a circle with given radius, tangential to two other 
objects). The order of the parameters in a sequence is always 
definitive. 


Point Defining Commands 


< coord > 
Locates a point at the specified position. 
coord: the position of the point. 


E.g.: /POINT 100 130; 
a point will be created at the position 100, 130. 


< prim > 


Divides the selected object along its length {or perimeter) into "n" 
equal portions (where "n" is the Preferred Repeat Factor) and 
creates a point at the endpoints of each portion. 


E.g.:  /REPEAT 5; 
sets the Preferred Repeat Factor to 5. 


{/DPOINT 160 150; 
divides the object into 5 portions. 
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Line Defining Commands 


LINE << coord > ENTER > 
_ Defines a series of lines connected at the endpoints. 


coord: an endpoint of a line. 
ENTER: completes a series of connected lines and repeats the 
command (i.e. starts another series of lines). 


E.g.: 
/LINE 40 100 70 50 100 110 110 60; 150 80 200 60 230 100 200 130 160 120;; 


the first ENTER (:): terminates the first series of lines, 

the second ENTER: terminates the second series of lines, 

the third ENTER: (immediately after the second one) terminates 
the command. 
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LINESINGLE  < coord! coord2 > 
Defines single lines by their endpoints. 


coord1: the startpoint of a single line, 
coord2: the endpoint of a single line. 


E.g.: /LINE SINGLE 100 100 150 140 160 110 170 150 186 90 230 110; 
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LINE PERPENDICULAR =< coord > prim 


Defines a line starting from the selected point and perpendicular to 
a selected object. 


coord: the endpoint of the line, 
prim: the object the line wi!l be perpendicular to. 


E.g.: 

Draw a line: 

/LINE SINGLE 4110 160 180 110; 

Draw a line starting from the point (100; 100) perpendicular to the 


previously defined line: 
/LINE PERPENDICULAR 100 100 150 130; 
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LINE HORIZONTAL 


LINE VERTICAL 


< coord? coord2 > 

Defines single horizontal lines. 

coord1: the startpoint of a horizontal line, 

coord2: the x coordinate defines the endpoint of the line. The y 
coordinate will be ignored. 


Eg:  /LINE HORIZONTAL 60 160 110 140 70 180 140 200; 
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< coord! coord2 > 

Defines single vertical lines. 

coord!: the startpoint of a vertical line, 

coord2: the y coordinate defines the endpoint of the line. The x 
coordinate will be ignored. 

E.g.: /LINE VERTICAL 90 110 60 180 130 160 180 120; 
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LINE HV < < coord > ENTER > 


Defines a series of connecting horizontal or verticai lines, 

depending on the direction defined by the endpoint of the previous 
line and the latest defined point. If this direction is closer to 
horizontal, the line will be horizontal, if closer to vertical, it will be 
vertical. 


The startpoint of a segment is the first defined point or the endpoint 
of the previous line, the endpoint is defined by the x- or y - 
coordinate of the defined point in the case of horizontal or vertical 
lines respectively. 


coord: the first coord defines the startpoint of the series of 
horizontal-vertical lines, 
the following coord-s define the direction and the 
endpoints of the segments, 

ENTER: completes a series of lines and starts the sequence 
again. 


E.g:  /LINE HY 100 100 80 140 460 120 180 165;; 
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LINE SINGLE HV 


E.g.: 


LINE BITANGENT 


< coord! coord? > 


Defines a series of single, horizontal or vertical lines, depending on 
whether the coord - coord? direction is closer to horizontal or 
vertical. 


coord1: the startpoint of the line, 

coord2: the x or y component of this pair of coordinates 
defines the endpoint of the horizontal or vertical jine 
respectively. 


/LINE SINGLE HV 100 100 80 140 120 130 170 150 180 140 200 90; 
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< prim? prim2 > 


Defines a line tangent to two chosen objects. The endpoints of the 
line are the tangent points nearest to the selected points. 


prim1: the first selected object, 
prim2: the other selected object. 


E.g.: Create a circle and an arc: 
/CIRCLE CPOINT 100 100 130 130; 
Create an arc: 
/CARC P3 160 110 180 80 220 110; 
Draw a line tangent to the circle and the arc: 
/LINE BITANGENT 75 65 160 80; 
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LINE PTANGENT = < coord < prim > ENTER > 


Draws lines from a specified startpoint tangent to the selected 
objects. The endpoint of a line is the tangent point. Additional lines 
can be drawn from the same startpoint if there is more than one 
possible tangent point. 


coord: the starting point of the tangent lines, 
prim: a selected object, 
ENTER: completes drawing lines from the current starting point 


and prompts for another starting point. Giving ENTER 
again quits the command. 


E.g.: Draw a circle: 
/CIRCLE CPOINT 175 175 190 175; 


draw an arc: 
/CARC CPOINT 220 130 220 150 240 130; 


draw a spline: 
/SPLINE 139 90 135 100 160 80 185 75; 


draw tangent lines from the point (80; 140) to all the three 
objects: 
/LINE PTANGENT 80 140 190 175 200 130 150 90;; 
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LINE AXIS 


LINE AXIS HV 


< coord! < coord2 coord3 > ENTER > 


Defines lines passing through the first point, starting from the 
second point and ending where it comes nearest to the third point. 


coord1: = the axis point, 

coord2: the startpoint of the line, 

coord3: the point defining the endpoint of the line, 

ENTER: completes drawing lines through the current axis and 
prompts for another starting point. Giving ENTER again 
quits the command. 


E.g.:  /LINE AXIS 130 130 100 435 70 160 220 170 170 120;; 
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< coord? < coord2 coord3 > ENTER > 


Defines horizontal or vertical lines passing through the first point. A 
line will be horizonta! or vertical depending on whether the coord] - 
coord2 direction is closer to horizonta! or vertical. Its endpoints will 
be the points where it comes nearest to points 2 and 3. 


coordt: the axis point, 

coord2: defines the startpoint of a line, 

coord3: defines the endpoint of a line, 

ENTER: completes drawing lines through the current axis and 
prompts for another starting point. Giving ENTER again 
quits the command. 


E.g:  /LINE AXIS HV 100 100 200 90 130 80 80 140 115 85;; 
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BEVEL «length < prim? prim2 > ENTER > 


Draws lines which intersect two non-parallel Sines creating a bevel, 
or chamfer. The startpoint of the bevel is located on the first 
selected object at a specified distance from the intersection (or 
apparent intersection) with the second object. The angie between 
the bevel and the first selected object is the Preferred angle. The 
command mutilates or extends both objects if necessary. 


length: the distance of the bevel from the intersection point 
measured along the line of the first selected object, 

prim1: a point nearby the object to be selected first, 

prim2: a point nearby the object to be selected second, 


ENTER: completes the bevel using the given distance and 
prompts for another distance. Giving ENTER again quits 
the command. 


E.g.: Create two lines: 
/LINE SINGLE 30 60 70 140 100 70 70 120; 


Create a bevel between the two lines: 
/BEVEL 40 30 60 100 70;; 
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CONSTLINE 


Construction Line Defining Commands 


The construction line is a special kind of line which is drawn from 
one edge of the drawing window to the other. 

< coord! coord2 > 

Defines a construction line by two points. 


coord!1: a point of the construction line, 
coord2: = another point of the construction line. 


E.g.: /CONSTLINE 50 100 150 90 ; 
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CONSTLINE PARALLEL  < prim < coord > ENTER > 


Defines construction lines passing through the second defined 
point, aligned to an object nearest to the first given point. 


prim: a point nearby the object the construction line will be 
aligned to, 

coord: a point of the construction line, 

ENTER: completes drawing construction lines aligned to the 


selected object and prompts for selecting another 
object. Giving ENTER again quits the command. 


E.g.: /CONSTLINE PARALLEL 80 130 150 90;; 
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CONSTLINE DPARALLEL 


< prim < length > ENTER > 


Defines a construction line aligned to an object nearest to the given 
point, at a given distance from the nearest point of the object to the 
given one. 

Positive distance values represent that side of the object where the 
chosen point is situated. 


prim: a point nearby the object the construction tine will be 
aligned to, 
length: the distance of the construction line from the object, 


ENTER: restarts the command. 


E.g.: /CONSTLINE DPARALLEL 80 90 25;; 
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CONSTLINE PERPENDICULAR ~~ < prim < coord > ENTER > 


Defines a construction line passing through the given point and 
perpendicular to the object nearest to the selected point. 


prim: a point nearby the object the construction line wiil be 
perpendicular to, 
coord: a point of the construction line, 


ENTER: completes drawing lines perpendicular to the given 
object and prompts for selecting another object. 


E.g.: /CONSTLINE PERPENDICULAR 50 90 150 990;; 
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CONSTLINE DFPOINT 





< coord > 


Defines construction lines passing through the given points at the 
Preferred angle. 


coord: 2 point of the construction line. 


Eg: /CONSTLINE DFPOINT 40 100 90 80 160 120; 
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CONSTLINE DFTANGENT 





< prim > 


Defines a construction line whose angle is determined by the 
Preferred angle and tangent to the selected object nearest to the 
selected point. 


prim: a point nearby the chosen object. 


E.g.: /CONSTLINE DFTANCENT 105 120; 
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CONSTLINE TANGENT 


< prim > 


Defines construction lines tangent to the selected object nearest to 
the chosen point. 


prim: a point nearby the chosen object. 


E.g.: /CONSTLINE TANGENT 105 135 75 90; 
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CONSTLINE BITANGENT =< prim prim2 > 


Defines construction lines tangent to two selected objects nearest 
to the chosen points. 


prim1: a point nearby one of the chosen objects, 
prim2: a point nearby the other chosen object. 


E.g.: /CONSTLINE BITANGENT 80 110 160 140; 
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CONSTLINE PTANGENT =< coord < prim > ENTER > 


= Defines construction lines passing through a point and tangent to 
objects. After ENTER another point can be defined. 


coord: a point of the construction fine, 

7 prim: the object the construction line will be tangent to, 
ENTER: restarts the command, 
E.g.: 


a /CONSTLINE PTANGENT 30 110 130 160 85 70;180 120 130 120 120 90;; 


_ ‘ "E80. 920) 





Construction Line Defining Commands 45 


Polyline Defining Commands 


POLYLINE << coord > ENTER > 


Defines polylines that pass through specified nodes. 

coord: a node of a polyline, 

ENTER: completes a polyline (to the last defined node) and 
starts another one. 


£.2: /POLYLINE 30 100 60 140 90 130 120 140; 130 120 140 90 160 95 165 110;; 
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POLYGON < < coord > ENTER > 


Draws closed polylines (irregular polygons) by the vertices. ENTER 
completes the polygon (connecting the first and last vertices) and 
repeats the commana. 


coord: a vertex of the polygon, 
ENTER: completes a polygon (to the last defined node) and 
starts another one. 


E.g.: /POLYGON 30 120 40 80 80 85 90 130; 120 110 120 80 150 90 140 120;; 
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POLYGON REGULAR 


RECTANGLE 


[{ IN | OUT} ] < num < coord > ENTER > 


Defines a regular polygon that is inscribed in or circumscribed 
around a circle of the Preferred radius. The palygon is rotated by 
the Preferred angle (a vertex of the polygon wil! be in the Preferred 
angle from its center). The number of polygon edges and the 
location of the center point is specified. If the keyword IN or OUT 
is missing, the default is IN. 


IN: defines an inscribed polygon, 

OUT: defines a circumscribed polygon, 

num. number of edges, 

coord: center of the polygon, 

ENTER: prompts for another number of edges. Giving an 


ENTER again quits the command. 


E.g.: /POLYGON REGULAR IN 6 100 120;; 
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< coord! coord2 > 
Defines rectangles by their opposite corners. 


a cornerpoint of the rectangle, 
the opposite corner of the rectangle. 


coord!1: 
coord2: 


E.g.: /RECTANGLE 70 140 150 100 170 110 200 135; 
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Circle Defining Commands 


CIRCLE < coord > 


Draws circles at the specified center points whose radius is the 
Preferred radius. 


coord: the center of the circle. 


Eg: /CIRCLE 50 100 150 100; 
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CIRCLE CPOINT =< coord! coord2 > 
Defines circles by the center and a point on the perimeter. 


coord!: = the center point, 
coord2: a point of the circle. 


E.g.: /CIRCLE CPOINT 70 100 90 110 140 90 130 80; 
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CIRCLE CTANGENT 


< coord prim > 


Defines circles with a given center and tangent to the given object 
(nearest to the chosen point). 


coord: the center point, 
prim: a point near the object the circle will be tangent to. 


F.g.:  /CIRCLE CTANGENT 65 125 100 90 55 60 30 110; 
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CIRCLE BITANGENT 


CIRCLE P3 


< prim? prim2 > 


Defines circles with the Preferred radius, tangent to both given 
objects (nearest to the chosen points). 


primi: a point near one of the chosen objects, 
prim2: a point near the other chosen object. 


Eg: /CIRCLE BITANGENT 30 110 130 60; 
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< coord! coord2 coord3 > 

Defines circles by three points. 

coord1: =a point of the circle, 

coord2: another point of the circle, 

coord3: — the third point of the circle. 

E.g.: /CIRCLE P3 40 80 60 100 50 60 120 60 130 90 165 85; 
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CIRCLE P2TANGENT 


CIRCLE PBITANGENT 


< coord’ coord2 prim > 


Defines circles passing through two given points and tangent to the 
object nearest to the third chosen point. 


coord): a point of the circle, 
coord2: — another point of the circle, 
prim: a point near the chosen object. 


E.g.: /CIRCLE P2TANGENT 50 80 80 50 100 100; 
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< coord prim1 prim2 > 


Defines circles passing through a given point and tangent to both 
given objects (nearest to the chosen points). 


coord: a point of the circle, 
prim1: a point near one of the chosen objects, 
prim2: a point near the other chosen object. 


E.g.: /CIRCLE PBITANGENT 100 80 60 85 110 130; 
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CIRCLE TRITANGENT = < prim1 prim2 prim3 > 


Defines a circle tangent to all the three objects nearest to the 
chosen points. 


prim1: a point near one of the chosen objects, 
prim2: a point near another chosen object, 
prim3: a point near the third chosen object. 


Eg: /CIRCLE TRITANGENT 50 85 70 90 90 135; 
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Ci 


rcular Arc Defining Commands 





CARC <coord > 


a 


CARC P3 


Defines a circular arc at a specified center point. Its radius is the 
Preferred radius, its endpoints are determined by the Preferred end 


ngles. 


coord: the center point of the arc. 


Eg:  /CARC 50 100 150 110; 
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< coord? coord2 coord3 > 
Defines a circular arc that passes through three specified points. 


The first and third points are the endpoints of the arc. 


one of the endpoints of the arc, 


coordt: 

coord2: an interna! point of the arc, 

coord3: the other endpoint of the arc. 
2 
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CARC CPOINT 


CARC BITANGENT 


< coord! coord2 coord3 > 
Defines a circular arc by its center point and the endpoints. 
coord1: the center point of the arc, 


coord2: an endpoint of the arc, 
coord3: the other endpoint of the arc. 


< prim? prim2 > 


Defines a round-off of the Preferred radius between two objects 
nearest to the chosen points. 


primi: a point near one of the objects, 
prim2: a point near the other object. 


Chapter 2: Detailed Description of Commands 


FILLET 


CCURVE [SMOOTH] 


< prim1 prim2 > 


Defines a round-off, using the Preferred radius, between two 
selected objects. This command either truncates or adds to the 
length of the selected objects. The endpoints opposite the round-off 
remain unchanged. 


prim1: a point near one of the objects, 
prim2: a point near the other object. 


< coord! coord2 coord3 < coord4 > ENTER > 


Defines a smooth curve composed of circular arcs. The first three 
points define the first circular arc, and the remaining points are the 
endpoints of the connecting arcs, the connection is smooth. 


coord1. 
coord?2: 
coord3: 
coord4: 


ENTER: 


the starting point of the first arc, 

an internal point of the first arc, 

the endpoint of the first arc, 

the endpoints of the consequent arcs, 
completes the curve and repeats the command. 
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CCURVE CONTIGUOUS = < coord! coord2 coord3 < coord4 coord5 > ENTER > 


Defines a contiguous curve composed of circular arcs. The first 
three points define the first circular arc, the endpoint of the 
previous arc and two additional points define the next arc. 


coord1: 
coord2: 
coord3: 
coords: 
coords: 


ENTER: 


the starting point of the first arc, 

an internal point of the first arc, 

the endpoint of the first arc, 

an internal point of the next arc, 

the endpoint of next arc, etc. 

completes the curve and repeats the command. 
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ELLIPSE 


ELLIPSE FDISTANCE 


Ellipse Defining Commands 


< coord > 

Defines an ellipse at a specified center point. Its size is determined 
by the Preferred half axes. The angle of the major axis is the 
Preferred angle. 


coord: the center point of the ellipse. 


< coord! coord2 length > 


Defines an ellipse by its focus points and the sum of the distances 
between each focus point and a point on the perimeter. 


coordi: one of the focus points of the ellipse, 


coord2: the other focus point of the ellipse, 
jength: length of the major axis of the ellipse. 


Ellipse Defining Commands 


a7. 


ELLIPSE FPOINT  < coord! coord2 coord3 > 
Defines an ellipse by its focus points and a point on its perimeter. 
coord: one of the focus points of the ellipse, 


coord2: _ the other focus point of the ellipse, 
coord3: a perimeter point of the ellipse. 
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EARC 


EARC FPOINT 


Elliptic Arc Defining Commands 


< coord > 


Defines an elliptic arc at a specified center point. Its size is 
determined by the length of the Preferred half axes, its endpoints 
are determined by the Preferred end angies. The angle of the major 
axis is the Preferred angle. 


coord: the center point of the elliptic arc. 


< coord! coord2 coord3 coord4 > 


Defines an elliptic arc specified by its foca! points, one of its 
endpoints, and a nearby point to the other endpoint. The arc is 
drawn counter-clockwise. 


coord!: 
coord2: 
coord3: 
coord4: 


» 


one of the focal points of the elliptic arc, 
the other focus point of the arc, 

one of the endpoints of the arc, 

a point near the other endpoint of the arc. 


Elliptic Arc Defining Commands 


ag 


Spline Defining Commands 


SPLINE [OPENED] << coord > ENTER > 


Defines open splines that pass through specified nodes. The length 
of the end tangents is zero. 


coord: a node of the spline, 
ENTER: completes a spline and repeats the command. 


2 4 


oe 


SPLINE CYCLIC << coord > ENTER > 


Defines closed splines that pass through specified nodes. The 
tangent vectors in the first and last points are identical. 


coord: a node of the spline, 
ENTER: completes a spline and repeats the command. 
4 


Lv! 
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SPLINE ANTICYCLIC 


< < coord > ENTER > 


Defines a closed spline that passes through specified nodes. The 
tangent vectors in the first and last points are opposite. ENTER 
completes the spline and repeats the command. 


coord: a node of the spline, 
ENTER: completes a spline and repeats the command. 


4 
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Text Defining Command 


TEXT  < coord > 
The command locates the Preferred text at the given position. 
coord: the position of the text origin. 


E.g.:  /TEXT 30 100 50 130; 


Preferred text 


(50: 130) 


Preferred text 


(30. 100} 
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HATCH 


Hatch Defining Commands 


{IN | OUT } <sefect > {ENTER | HOLE < select > ENTER } ENTER 


Hatches the area inside or outside closed chains of objects. The 
chain must be entered object by object. 


The optional HOLE keyword must be followed by a list of 
dimensions and textual objects. A rectangle around these objects 
will be left out of hatching. 


iN: 
OUT: 
select: 
ENTER: 
HOLE: 


select: 
ENTER: 


ENTER: 


hatching inside the selected area, 

hatching outside the selected area, 

selection of the objects bordering the area to be hatched, 
completes the selection of a hatch boundary, 

the following text and dimension type objects will be 
excluded from hatching, 

selection of text and dimensions to be excluded from 
hatching. 

completes the selection of text and dimensions to be 
excluded from hatching, 

completes the selection of the areas to be hatched. 


E.g.: /HATCH IN 20 100 70 70 145 120 75 160; HOLE 130 100;; 





Yy 






, 160) 


Yj 
Yi 
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SYMBHATCH [IN | OUT} name <select > { ENTER | HOLE < select > ENTER } 
ENTER 


Identical to HATCH {IN | OUT } (see above) but hatches the area 
using the specified symbol as the hatch pattern. The symbo! may 
only contain straight lines and its appearance is determined by the 
Preferred transformation. 


The optional HOLE keyword must be followed by a list of 
dimensions and textual objects. A rectangle around these objects 
will be left out of hatching. 


IN: hatching inside the selected area, 

OUT: hatching outside the selected area, 

name: name of the symbol forming the hatch pattern, 

select: selection of the objects bordering the area to be 
hatched, 

ENTER: completes the selection of a hatch boundary, 

HOLE: the following text and dimension type objects will be 
excluded from hatching, 

select: selection of text and dimensions to be excluded from 
hatching, 


ENTER: completes the selection of text and dimensions to be 
excluded from hatching, 
ENTER: completes the selection of the areas to be hatched. 


E.g.: 
/SYMBHATCH IN hatch1 20 100 70 70 145 120 75 160; HOLE 130 100;; 


] (145, 120) 





(70: 70} 
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HATCH CHAIN 


{IN | OUT) <select > { ENTER | HOLE select ENTER } ENTER 


Hatches the area inside or outside closed chains of objects. A 
whole chain of objects is defined at once by specifying any object 
in the chain. 


The optional HOLE keyword must be followed by a list of 
dimensions and textual objects. A rectangle around these objects 
will be left out of hatching. 


iN: 
OuUT: 
select: 


ENTER: 


HOLE: 


select: 


ENTER: 


ENTER: 


£E.g.: 


{20, 100) y 


hatching inside the selected areas, 

hatching outside the selected areas, 

selection of the chains bordering the areas to be 
hatched, . 

completes the selection of the areas of hatching, 

the following text and dimension type objects will be 
excluded from hatching, 

selection of text and dimensions to be excluded from 
hatching. 

completes the selection of text and dimensions to be 
excluded from hatching, 

completes the collection of data. 


{HATCH CHAIN IN 20 100 HOLE 130 100;; 
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SYMBHATCH CHAIN 


{IN | OUT} name < select > { ENTER | HOLE < setect > ENTER } 
ENTER 


Identical to HATCH CHAIN (IN | OUT } (see above) but hatches 
the area using the specified symbo! as the hatch pattern. The 
symbol may only contain straight lines and its appearance is 
determined by the Preferred transformation. 


The optional HOLE keyword must be followed by a list of 
dimensions and textual objects. A rectangle around these objects 
will be left out of hatching. 


IN: hatching inside the selected areas, 

OUT: lah outside the selected areas, 

name: name of the symbol forming the hatch pattern, 

select: selection of the chains bordering the areas to be 
hatched, 

ENTER: completes the selection of the areas of hatching, 

HOLE: the following text and dimension type objects will be 
excluded from hatching, 

select: selection of text and dimensions to be excluded from 
hatching. 


ENTER: completes the selection of text and dimensions to be 
excluded from hatching, 
ENTER: — completes the collection of data. 


E.g.: /SYMBHATCH CHAIN IN hatch! 20 100 HOLE 130 100;; 





SW A x x 
XXX RARER 
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HATCH INTCHAIN {IN | OUT} <select > { ENTER | HOLE select ENTER } ENTER 


Hatches areas inside or outside the selected closed chains. A pick 
selects a closed chain together with all its internal chains (only one 
level deep). A whole chain of objects is defined at once by 
specifying any object in the chain. 


-- The optional HOLE keyword must be followed by a list of 
dimensions and textual objects. A rectangle around these objects 
will be left out of hatching. 


IN: hatching inside the selected areas, 

OUT: hatching outside the selected areas, 

select: selection of the chains bordering the areas to be 
7 hatched, 

ENTER: completes the selection of the chains, 

HOLE: the following text and dimension type objects will be 

excluded from hatching, 

select: selection of text and dimensions to be excluded from 

> hatching. 


ENTER: completes the selection of text and dimensions to be 
excluded from hatching, 
ENTER: cornpletes the collection of data. 


E.g.: /HATCH INTCHAIN IN 20 100 HOLE 130 100;; 


ol rT 
Y 


7 


(20: 100) P 
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SYMBHATCH INTCHAIN {IN | OUT} name < select > {ENTER | HOLE < select > ENTER } 
ENTER 

identical to HATCH SNTCHAIN {iN | OUT } (see above) but 
hatches the area using the specified symbol as the hatch pattern. 
The symbol may only contain straight lines and its appearance is 
determined by the Preferred transformation. 


The optional HOLE keyword must be followed by a list of 
dimensions and textual objects. A rectangle around these objects 
will be left out of hatching. 


IN: hatching inside the selected areas, 

OUT: hatching outside the selected areas, 

name: name of the symbol forming the hatch pattern, 

select: selection of the chains bordering the areas to be 
hatched, 

ENTER: completes the selection of the chains, 

HOLE: the following text and dimension type objects will be 
excluded from hatching, 

select: selection of text and dimensions to be excluded from 
hatching. 


ENTER: completes the selection of text and dimensions to be 
excluded from hatching, 
ENTER: completes the collection of data. 


E.g.: /SYMBHATCH INTCHAIN IN hatch? 20 100 HOLE 130 100;; 


x 
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DIMENSION 


Dimensioning C ommands 


[{LILX!LY}]  <prim coord > 


Dimensions the selected objects. The position of the dimension line 
is defined by a given point. 


L: 
ix: 
LY: 


prim: 


dimensions paralle! to the object, 

dimensions the horizontal projection of the object, 
dimensions the vertical projection of the object. 
The default qualifier is ¢. 

the object to be dimensioned, 


coord: the position of the dimension. 


E.g.: 


E.g.: 


E.g.: 


/DIMENSION L 50 80 40 90; 





/DIMENSION LX 50 80 50 50; 


{SO 80) 


75.10 
(30 $0; 


/DIMENSION LY 50 80 120 75; 


($C 80) 
M20 73) 
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DIMENSION 


{ DISTANCE | DISX | DISY} < coord! coord2 coord3 > 


Dimensions the distance between two selected points or its 
projections. 


DISTANCE: dimensions the distance, 


DISx: dimensions the horizontal projection of the 
distance, 

DISY: dimensions the vertical projection of the distance, 

coord: a point near the first chosen point, 

coord2: a point near the other chosen point, 

coord3: position of the dimension. 


E.g.: /DIMENSION DISTANCE 40 70 100 100 40 90; 






(100 160} 


E.g.: /DIMENSION DISX 40 70 100 160 50 50; 





{$0. 30} 


E.g.:  /DIMENSION DISY 40 70 100 100 120 75; 


(100. 100} 


{40 70) i120 73) 
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DIMENSION 


{ DANGLE | CANGLE} < prim? prim2 coord > 


Dimensions the angie between two objects at the intersection point, 


regardiess which one is selected first. 


DANGLE: dimensions the smaller angle between the objects, 
CANGLE: dimensions the complementary angle between the 


prim: 
prim2: 
coord: 


E.g.: 


E.g.: 


objects, 

a point near one of the objects, 
a point near the other object, 
position of the dimension. 


{DIMENSION DANGLE 55 150 85 130 60 120; 


{55, 1506} 


'@S, 130) 


Zi 


(60: 120) 


{DIMENSION CANGLE 55 150 85 130 60 120; 






(55, 150) 







(60, 120) 7. 


Dimensioning Commands 


71 


DIMENSION {AX 1 AY 1CAX 1 CAY} <prim coord > 


Dimensions the angle between the object and the horizonta! or 
vertical axis (determined by the position of the pick) or the 
complementary angle. The dimension line passes through the given 


POINt. 


AX: — dimensions the angle between the object and the +x-axis, 

AY: dimensions the angle between the object and the +y-axis, 

CAX: dimensions the complementary angle between the object 
and the +x-axis, 

CAY: dimensions the complementary angle between the object 
and the +y-axis, 

prim: a point near the object to be dimensioned, 

coord: a point locating the dimension. 


DIMENSION PARALLEL =< prim prim2 coord > 
Dimensions the distance between two selected paraile! lines. 
prim1: a point near one of the objects to be dimensioned, 


prim2: a point near the other object, 
coord: a point locating the dimension. 
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DIMENSION DRADIUS 


DIMENSION RINTERNAL 


< prim coord > 


Dimensions the radius outside or inside a circle or circular arc. The 
inside dimension line starts from the centrepoint of the circle or 
circular arc and the text is in the bisector; dimensioned outside, the 
text is located above the given point. 


prim: a point near the object to be dimensioned, 
coord: a point locating the dimension. 





< prim coord > 


Dimensions the radius outside or inside a circle or circular arc. The 
text is above the given point. 


prim: a point near the object to be dimensioned, 
coord: a point locating the dimension. 





Dimensioning Commands 


73 


74 


DIMENSION DIAMETER 


DIMENSION DFIX 


< prim coord > 


Dimensions the diameter outside or inside a circle. The text is 
above the given point. The dimension line passes through the given 
point. 


prim: a point near the object to be dimensioned, 
coord: a point locating the dimension. 


< prim coord > 


Dimensions the diameter outside or inside a circle. The direction of 
the dimension line is the Preferred direction. The distance of the 
given point from the centrepoint of the circle indicates the position 
of the dimensioning text. 


prim: a point near the object to be dimensioned, 
coord: a point locating the dimension. 
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DIMENSION DEXTERNAL 


DIMENSION ARROW 


< prim coord > 


Dimensions the diameter outside a circle. The direction of the 
dimension line is the Preferred direction. The dimension line passes 
through the given point. 


prim: a point near the object to be dimensioned, 
coord: a point locating the dimension. 


< coord] coord2 { ENTER | coord3 ) ENTER | coord4 } } > 


Defines a leader line without any text. The number of the segments 
may vary from 1 to 3. The arrow is at the end of the line. 


coord1: the starting point of the first segment, 
coord2: the endpoint of the first segment, 

ENTER: completes the one-segment leader line, 
coord3: the endpoint of the second segment, 

ENTER: completes the two-segment leader line, 
coord4: = the endpoint of the three-segment leader fine. 


E.g.: /DIMENSION ARROW 30 90 50 100 120 100 140 120; 


(340, 120) 
(50: 160) 


{120; 100) 
(30: 90} 
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DIMENSION 


( DISX | DISY } {SERIAL | CUMULATIVE ! PARALLEL | PROGRESSIVE } < 


coord! coord2 coord3 < coord4 > ENTER > 


Defines a serial (continuous), a parallel, a cumulative (baseline), or a 
progressive (ordinate) dimension group. The interpretation of the 
first three points is identical to the case of normal dimensioning 
between two points. Entering additional points, additional 
dimensions are‘created (in the case of parallel dimensioning the 


distance between 
character height). 


DISx: 

DISY: 

SERIAL: 
CUMULATIVE : 
PARALLEL : 
PROGRESSIVE : 
coord1: 
coord2: 


coord3: 
coord4: 
ENTER : 


the two neighbouring dimension lines depends on 


defines horizontal dimensions, 

defines vertical dimensions, 

defines continuous dimensions, 

defines baseline dimensions, 

defines parallel dimensions, 

defines ordinate dimensions, 

starting point of the dimensioning, 

a point near the first point to be dimensioned 
from coord!, 

a point locating the dimension, 

points near the next points to be dimensioned, 
completes a series of dimensions. 


SERIAL (continuous): 





76 
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PARALLEL (parallel): 





PROGRESSIVE (ordinate): 


15.0 


= 
t~ 
“ 


6.0 


is 
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Symbol Defining Command 


SYMBDEF  < symb select coord > 


Creates a symbo! with the given name. The symbol comprises the 
selected objects, its origin is the given point, 

Replaces the unresolved symbol references of the given name with 
the newly created symbol (see the example below). 


symb: the name of the symbol being created, 

select: selection of objects (points near the objects Comprising the 
symbol}, 

coord: the origin of the symbol. 


Eg: You can locate so called “unresolved” symbo's in the 
drawing (which are currently not in the symbol table, 
consequently, they are displayed in the drawing by their 
name: 

/POSITION SYMBOL symbolt 140 170 170 120; 

Symp oi 


140. 176) 


gympoi1 


i170 120} 
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Draw then create the symbo!: 


/SYMBDEF symbol1 180 180 200 160 190 170; 200 180; 
(the first ENTER (;) completes the selection) 






(180. 180) 


(190. 170) 


+e 


{200 160! 


The command defines the symbo! “symbol1" and the defined 
symbo! replaces the symbol names "symbolt” .e. absoives the 
unresolved symbol references: 
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DELETE ALL 


DELETE 


DELETE SELECT 


DELETE PART 


Editing Commands 


Modifying C ommands 


Deletes all existing objects (on all layers!). The deleted objects are 
revokable using the UNDO command. 


< prim > 


Deletes the chosen object. The deleted objects are revokable using 
the UNDO command. 


prim: a point near the object to be deleted. 


< select > 


Deletes the selected group of objects. The deleted objects are 
revokable using the UNDO command. 


select: selection of the objects to be deleted. 


< coord! coord2 > 


Deletes al! items inside a window. Objects partially inside the 
window are cut and only the inner part will be deleted. The deleted 
objects are revokable using the LNDO command. 


coord1: a corner point of the window, 
coord2: the other corner point of the window. 
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PDELETE 


CUTTING 


CUTTING FIRST 


CUTTING SECTION 


< prim > 

Deletes the nearest part of the object to the chosen point, between 
the neighbouring intersection points or endpoints of the object. The 
deleted objects are revokable using the UNDO command. 


prim: a point near the object section to be deleted. 


< prim? prim2 > 


Cuts the two objects at their intersection point closest to the 
selection point. 


prim1: a point near one of the objects to cut, 
prim2: a point near the other object to cut. 


< prim] prim2 > 


Cuts the first selected object at the intersection point of the two 
Objects closest to the selection point. 


primt: a point near the objects to cut, 
prim2: a point near the cutting object. 


< coord! coord2 < coord2 > ENTER > 


Cuts a set of objects with a line given by its endpoints. The line is 
present only while entering the objects to be cut. 


coordt: the starting point of the cutting section, 
coord2: =the endpoint of the cutting section, 
coord2: points near the abjects to cut, 

ENTER: completes a series of cutting. 
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CUTTING { ALL | HERE } 


ADJUST 


ADJUST FIRST 


ADJUST SELECT 


< prim > 


Cuts the object in its all or the nearest intersection point(s) with 
other objects. 


ALL: cuts the selected objects at its all intersection points, 

HERE: cuts the selected object at its intersection point nearest to 
the selection, 

prim: a point near the object to Cut. 


< prim! prim2 > 


Fits the two objects together by shortening or extending them up to 
their intersection point nearest to the given point. 
It retains the closer part of the objects to the pick point. 


primt: a point near one of the objects, 
prim2: a point near the other object. 


< prim? prim2 > 


Fits the first object to the second one by shortening or extending it 
up to that intersection point which is the closest to the pick points. 
It retains the closer part of the object to the pick point. 


prim1: a point near the object to adjust, 
prim2: a point near the object to which the first object will be 
adjusted. 


< prim select > 


Fits the selection of the objects against the first one. The longer part 
of each member of the selection will remain. 


prim: a point near the object to which the selected objects wili be 
adjusted, 
select: selection of the objects to adjust to the first one. 
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COMPLEMENT 


MODIFY DAUNIT 


MODIFY ENDPOINT 


MODIFY LENGTH 


< prim > 


Creates the complementary part of a circular or elliptic arc and 
deletes the original one. 


prim: a point near the object to complement. 
{ DECIMAL | DMS } < select > 


Modifies the angle unit of some existing angle dimensioning to 
decimal degrees or degrees/minutes/seconds. 


DECIMAL: sets the angle unit in the selected angle dimensions to 


decimal, 

DMS: sets the angle unit in the selected angle dimensions to 
degrees/minutes/seconds, 

select: selection of the angie dimensions to be modified. 


< prim coord > 


Shifts the nearest end to the pick point of the selected line, polyline, 
or circular arc into the given point. 


prim: a point near the endpoint of the object to be shifted, 
coord: the new position for the endpoint. 


< prim coord > 


Modifies the length of the selected line, polyline, circular arc or a 
part of a dimension in such manner that it moves the closer end of 
the object to the pick point along a construction line or arc in such 
way that it should be in closest position to the given point. 


prim: a point near the endpoint of the object to move, 
coord: a point defining the new position of the endpoint. 
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MODIFY NLENGTH 


MODIFY DIMENSION 


MODIFY PDIMENSION 


< prim length > 


Modifies the length of the selected line, polyline, circular arc or a 
part of a dimension to the given numeric vaive in such manner that 
it moves the closer end of the object to the pick point. 


rim: a point near the endpoint of the object to move, 
ength: the new length of the selected object. 


< prim coord > 
Moves the dimension to a new place defined by the given point. 


prim: a point near any part of the dimension to move, 
coord: a point defining the new position of the dimension . 


< prim coord > 


Moves a part of a dimension to a new position. 
If the selected part of the dimension is 
* an extension line: 
the endpoint closest to the point to be dimensioned will move, 
* a dimension line: 
the endpoint nearest to the given point will move on the original 
dimension line or circular arc of the dimension line to nearest 
position to the given point, 
e the text: 
it will be dragged to the new position. 


prim: a point near the part of the dimension to move, 
coord: a point defining the new position for the selected part of the 
dimension. 
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MODIFY TEXT 


EDIT 


MODIFY 


MODIFY 


< prim > 
Replaces the pointed text by the Preferred text. 


prim: a point near the text to replace. 


prim 

Opens a text editor and a window containing the selected text 
object. Leaving the editor the control returns to topCAD and the 
object will be replaced by the edited text. 


prim: a point near the text to be edited. 


{POLYLINE | SPLINE} ADDNODE  < prim coord > 


Adds a new node to the selected polyline or spline between the 
nodes limiting the part closest to the chosen point. 


POLYLINE: anew node will be added to the selected polyline part 
at the given point, 


SPLINE: a new node will be added to the selected spline part 
at the given point, | 

prim: a point near the object part the new node will be 
added to, 

coord: the place for the new node. 


{ POLYLINE | SPLINE] DELNODE < prim > 


Deletes the nearest node to the chosen point of the selected 
polyline or spline. 


POLYLINE: the polyline node nearest to the given point wil! be 


deleted, 

SPLINE: the spline node nearest to the given point will be 
deleted, 

prim: a point near the node to be deleted. 
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MODIFY (POLYLINE | SPLINE] MOVENODE < prim coord > 


Moves the selected node of the indicated polyline or spline to the 
giVeN position. 


POLYLINE: the polyline node nearest to the given point will be 


moved, 

SPLINE: the spline node nearest to the given point will be 
moved, 

prim: @ point near the node to move. 

coord: the new place for the node. 


MODIFY {POLYLINE | SPLINE} DELPART < prim > 


Deletes the nearest part to the chosen point of the indicated 
polyline or spline. 


POLYLINE: the polyline part nearest to the given point will be 


deleted, 

SPLINE: the spline part nearest to the given point will be 
deleted, 

prim: @ point near the object part to delete. 


MODIFY CONNECT ~~ << prim > ENTER > 


Connects the selected lines into a polyline using the ADJUST 
function to fit together the neighboring lines. 


prim: points near the objects, 
ENTER: completes selecting a set of lines, connects them together 


and prompts for selecting anather set of lines to be 
connected together. 


MODIFY POLYLINESMOOTH <prim> 


Replaces the polyline by a spline fitted to its nodes. 


prim: points near the polylines to smooth. 
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MODIFY 


MODIFY SPLINE 


MODIFY SPLINE ROUGH 


POLYLINE SLICE < prim > 
Cuts the polyline into lines. 


prim: points near the polylines to convert. 


{{ OPENED | CYCLIC | ANTICYCLIC ) < prim> | TANGENT < prim { 
coord | VECTOR length angle } > } 


« Modifies the type of spline to the given type, or 
e changes the tangent of an opened spline at the selected end 
graphically or numerically. . 


OPENED: the type of the selected spline will be changed to 
OPENED, 

CYCLIC: the type of the selected spline will be changed to 
CYCLIC, 

ANTICYCLIC: the type of the selected spline will be changed to 
ANTICYCLIC, 


prim: a point near the spline to modify, 
TANGENT: the tangent of the spline will be changed at the end 
nearer the selection, 


prim: a point near the spline whose tangent is to be 
changed, 

coord: the point defining the new tangent, 

VECTOR: the tangent will be defined numerically, 

length: the length of the vector defining the tangent of the 
spline at the end nearer the selection, 

angle: the angle of the vector defining the tangent of the 
spline. 

< prim > 


It replaces a spline with a polyline fitted to its nodes. 


prim: a point near the spline to Convert. 
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MODIFY SYMBPAR ~~ < prim num text > 


Changes a textual symbol attribute ($1, ..., $8) of the selected 
symbol. 


prim: a point near the symbol whose attribute is to be changed, 


num: the number of the symbo! parameter to be changed (1 ...8), 
text: the new (textual) value of the symbo! parameter. 


MODIFY SYMBNPAR << prim num1 num2 > 


Changes a numeric symbol attribute (#1, #2) of the selected 
symbol. 


prim: a point near the symbol whose attribute is to be changed, 


num1: the number of the symbol parameter to be changed (1,2), 
num2: the new (numerical) value of the symbol! parameter. 
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AUTONUMBER 


MODIFY 


{coord1 coord2 | ENTER } {num1 num? } 

{ {LEFT | RIGHT } { BOTTOM i TOP | ENTER} | { BOTTOM | TOP } 
{LEFT | RIGHT | ENTER} | ENTER) { num3 | ENTER } {num | 
ENTER } 

{ {LEFT | RIGHT } {BOTTOM | TOP } ENTER } | { BOTTOM | TOP } 
{LEFT | RIGHT | ENTER } | ENTER } {num5 | ENTER} {numé | 
ENTER } num7 select 


Numbers the selected group of the symbois. 


The program waits for 

e the corners of the window {ENTER means the tota! area) then 

e the numbers of the small boxes the window is divided into 
horizontally (num1) and vertically (num2). 


The sort of the boxes 

e will start from left, right, bottom, or top, 

e =the initial number will be num3, 

e the increment among the boxes will be num4. 
The sort of the symbols within a box 

e will start from left, right, bottom, or top, 

e = the initial number will be num5, 

e the increment among the symbols will be num6. 


The selected (#1 or #2) numeric parameter of the symbols will be 
numbered (nurmn7). 


Only the selected symbols (inside the window) wil! be numbered. 


< attribute < setting < select > > 
Changes the given attributes of the selected objects. 


attribute: keywords of attributes, 


setting: the new value for the selected attribute, 
select: selection of the objects whose attributes are to be 
modified. 
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MODIFY GROUP 


UNDO BACKWARD 


UNDO FORWARD 


UNDO [ON ! OFF) 


< < attribute setting > ENTER select > 

Changes all the selected attributes of the selected objects. 
attribute: keywords of attributes, 

setting: the new value for the selected attribute, 
ENTER: completes selecting and changing the attributes, 


select: selection of the objects whose attributes are to be 
modified. 


num 
Cancels the previous given number of operations. 


num: number of operations to cancel. 
num 


Validates again the given number of canceled operations. 


num: number of operations to validate again. 


Switches the UNDO function ON/OFF. 
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Move and Copy Commands 


MOVE _ prim 
Moves an object using the Preferred transformation. 


prim: a point near the object to be moved. 


DUPLICATE — prim 
Copies an object using the Preferred transformation. It executes the 


operation "n" times where "n" is the current value of the Preferred 
repeat factor. 


MOVE SELECT _ select 


Moves a selected group of objects using the Preferred 
transformation. 


select: selection of the objects to move. 


DUPLICATE SELECT select 
Copies a selected group of objects using the Preferred 
transformation. It executes the operation "n” times where “n" is the 
current value of the Preferred repeat factor. 


select: selection of the objects to copy. 


Move and Copy Commands 9} 


92 


MOVE PART 


DUPLICATE PART 


[coord1 coord2] 


Moves those object parts which fall inside a window using the 
Preferred transformation. 


coord1: a corner of the window, 
coord2: the opposite corner of the window. 


eP_te 


[coord coord2] 


Copies those object parts which fall inside a window using the 
Preferred transformation. 


coordt: a corner of the window, 
coord2: the opposite corner of the window. 
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MOVE CONTINUOUS 


7 OUPLICATE CONTINUOUS 


[coord1 coord2) 

Moves those object parts which fall inside a window using the 
Preferred transformation, than it reconnects the breakpoints of the 
objects with fines. 


coord!: a corner of the window, 
coord2: the opposite corner of the window. 


“oO. . 
ra <a 


[coord] coord2) 

Copies those object parts which fall inside a window using the 
Preferred transformation, than it reconnects the breakpoints of the 
objects with lines. 


coord1: =a corner of the window, 
coord2: =the opposite corner of the window. 
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STRETCH = [coord? coord2] 


Moves those object parts which fal! inside a window using the 
Preferred transformation. tf the object is a line or part of a polyline 
then topCAD transforms and moves only its endpoints and 
connects them with lines, otherwise it reconnects the breakpoints 
of the objects with lines. 


coord1: a corner of the window, 
coord2: the opposite corner of the window. 
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OFFSET 


< length < select > ENTER > 


Offsets a set of closed chains parallie! to themselves with the given 
distance. The chains must be entered object by object. The lines, 
polylines, circular arcs, and splines keep their type, the circles 
become circular arcs, the ellipses and elliptic arcs become splines. 


, tength: the offset distance, 
select: selection of the objects in a chain to offset 
(selecting the objects in a chain must be completed with 
an ENTER, another ENTER must be given to complete 
the selection), 
ENTER: prompts for another offset distance. 


E.g.: /OFFSET 4 140 80 137 137 95 140 42 136; 90 120; 
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OFFSET OPENCHAIN «length < prim > ENTER > 


Offsets a set of open chains parallel to themselves with the given 
distance. The chains must be entered chain by chain. The lines, 
polylines, circular arcs, and splines keep their type, the circles 
become circular arcs, the ellipses and elliptic arcs become splines. 


The whole chain or part of the chain can be selected: 


* pointing to the first or the last object in the chain nearer its free 
endpoint, the whole chain is selected, 

© pointing to the first or the last object in the chain nearer its 
endpoint connected to the next object, only that object is 
selected, 

© pointing to any other object in the chain, a part of the chain will 
be selected: from the object you pointed to, to that end of the 
chain which is farther from the selected point than from the 
midpoint of the segment of the chain nearest to the selection. 


length: the offset distance, 

prim: a point near an object in the chain to offset 
(selecting the chains must be completed with an 
ENTER), | 

ENTER: prompts for another offset distance i.e. restarts the 
command. 


E.g.:  /OFFSET OPENCHAIN 6 70 100; 
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OFFSET CHAIN =< length < prim > ENTER > 


Offsets a set of closed chains parallel to themselves with the given 
distance. A pick selects a complete chain. The chains must be 
entered chain by chain. The lines, polylines, circular arcs, and 
splines keep their type, the circles become circular arcs, the ellipses 
and elliptic arcs become splines. 


length: the offset distance, 

prim: @ point near an object in a chain to offset, 
(selecting the chains must be completed with an 
ENTER), 

ENTER: prompts for another offset distance i.e. restarts the 
command. 


E.g.: /OFFSET CHAIN 6 140 80; 
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OFFSET INTCHAIN =< length < prim > ENTER > 


Offsets a set of closed chains parallel to themselves with the given 
distance. A pick selects a complete chain with all its internal closed 
chains (only one level deep). The chains must be entered chain by 
chain. The lines, polylines, circular arcs, and splines keep their 
type, the circles become circular arcs, the ellipses and elliptic arcs 
become splines. 


Notice that the internal chains are outlined in the opposite direction 
than the directly selected chains. 


length: the offset distance, 

prim: a point near an object in a chain to offset, 
(selecting the chains must be completed with an 
ENTER), 

ENTER: prompts for another offset distance i.e. restarts the 
command. 


E.g.: /OFFSET INTCHAIN 6 140 80;; 
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NC 


< length < select > ENTER > 


Offsets a set of closed chains parallel to themselves exactly with the 
given distance at every point. The chains must be entered object by 
object. The lines, polylines, circular arcs, and splines keep their 
type, the circles become circular arcs, the ellipses and elliptic arcs 
become splines. tf it is necessary, topCAD inserts circular arcs. 


length: the offset distance, 

select: selection of closed chains to be outlined, 
(selecting the objects in a chain must be completed with 
an ENTER, another ENTER must be given to complete 
the selection), : 

ENTER: = prompts for another offset distance. 


E.g.: /NC 5 140 80 137 137 95 140 42 136; 90 120; 
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NC OPENCHAIN _ < length < prim > ENTER > 


Offsets a set of open chains parallel to themselves exactly with the 
given distance at every point. The chains must be entered chain by 
chain. The lines, polylines, circular arcs, and splines keep their 
type, the circles become circular arcs, the ellipses and elliptic arcs 
become splines. if it is necessary, topCAD inserts circular arcs. 


The whole chain or part of the chain can be selected: 


* pointing to the first or the last object in the chain nearer its free 
endpoint, the whole chain is selected, 

¢ pointing to the first or the last object in the chain nearer its 
endpoint connected to the next object, only that object !s 
selected, 

* pointing to any other object in the chain, a part of the chain will 
be selected: from the object you pointed to, to that end of the 
chain which is farther from the selected point than from the 
midpoint of the segment of the chain nearest to the selection. 


length: the offset distance, 
prim: a point near an object in the chain to offset 
(selecting the chains must be completed with an 
ENTER), 
ENTER: prompts for another offset distance i.e. restarts the 
command. 


Eg: /NC OPENCHAIN 5 70 100;; 
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NC CHAIN — < length < prim > ENTER > 


Offsets a set of closed chains paralle! to itself exactly with the given 
distance at every point. A pick selects a complete chain. The chains 
must be entered chain by chain. The lines, polylines, circular arcs, 
and splines keep their type, the circles become circular arcs, the 
ellipses and elliptic arcs become splines. If it is necessary, topCAD 
inserts circular arcs. 


length: the offset distance, 


prim: a point near an object in a chain to offset, 
(selecting the chains must be completed with an 
ENTER), 

ENTER: prompts for another offset distance i.e. restarts the 
command. 


E.g.: /NC CHAIN 5 40 80;; 
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NC INTCHAIN ~~ < length < prim > ENTER > 


Offsets a set of closed chains parallel to itself exactly with the given 
distance at every point. A pick selects a complete chain with ali its 
internal closed chains (only one fevel deep). The chains must be 
entered chain by chain. The lines, polylines, circular arcs, and 
splines keep their type, the circles become circular arcs, the ellipses 
and elliptic arcs become splines. ff it is necessary, topCAD insens 
circular arcs. 


Notice that the internal chains are outlined in the opposite direction 
than the directly selected chains. 


length: the offset distance, 


prim: a point near an object in a chain to offset, 
(selecting the chains must be completed with an 
ENTER), 

ENTER: prompts for another offset distance i.e. restarts the 
command. 


E.g.: /NC INTCHAIN 5 40 80;; 
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TiTEM 


COORDINATE 


7DISTANCE 


Query Commands 


[SPREADSHEET file} {< prim > | SELECT < select >} ENTER 


Displays or puts into a spreadsheet file the data of the selected 
objectis). Either general data (serial number, type, sizes of 
comprising rectangle, layer, color, line type, line width) or specific 
data {endpoints of a line, length, direction, centrepoint of a circle, 
radius etc.). 


[SPREADSHEET file]: the name of the file the output will be put 


into, 
prim: a point near the object whose data will be 
displayed, . 
SELECT: indicates that a set of objects will be 
selected, 
_ select: selection of a set of objects, 
ENTER: completes the selection of objects. 


< coord > ENTER 
Displays the coordinates of the selected point(s). 


coord: a point near the point to be selected, 
ENTER: completes selecting the points. 


< coord! coord2 > ENTER 


Displays the distance and its horizontal and vertical projection 
between two points. 


coord1: a point near one of the points, 


coord2: =a point near the other point, 
ENTER: completes selecting the points. 
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?7LENGTH 


?7ANGLE 


?GRID 


< length > ENTER 
Displays the selected length values. 


length: chooses the length to be displayed, 
ENTER: quits the command. 


E.g.:  /?LENGTH PERIMETER 100 100; 


The perimeter of the circle passing through the point 100, 
100 will be displayed in the command window. 


{/VLENGT L1 ?LENGTH SIZE 100 100; RECALL; 


The radius of the circle passing through the point 100, 100 
will be assigned to the length type variable “L1". 


< angle > ENTER 
Displays the given angle value(s). 


angle: selects the angles to be displayed, 
ENTER: quits the command. 


Displays a window with the grid data (line type, color number, 
rarefication factor, pen number, maximum number of lines, 
horizontal and vertical spacing). 
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7ATTRIBUTES 


TACTUAL 


Displays a group of the current attributes: 


*@ @@e@e@est#eaeeesees#kfges#sse?8e8e# @ 


color, 

line type, 

line width, 

window sizes, 

tolerance, 

length and angie units, 

character height, 

character width, 

space between the characters or lines, 

font (letter type), 

text direction and justification, 

character slant, 

Starting point, 

the format of the dimension, 

the text of tolerances, 

the number of decimals of length and angle dimensions, 
the type of the marker and its size, 

dimension scale factor and the location of the endpoints of 
projection lines. 


Displays the current values of the Preferred parameters (used by 
certain object defining commands): 


Preferred radius, 
Preferred half axes of an ellipse, 
Preferred angle, 
Preferred end angles of a circular arc or elliptic arc, 
Preferred repeat factor, 
parameters of the Preferred transformation: 
* transfation vector, 
* rotation angie, 
e scale factors, 
Preferred text. 
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7SPACE 


?7HATCH 


{MENU 


7UNDO 


?7LAYER 


?SNAP 


set 

Displays the space data about the selected layer(s) or all layers 
(occupied area in kbytes and in block number, total number of 
objects and symbols, the number of objects by layers and by 

types). 


set: set of layers. 


< prim > ENTER 


Displays the data of the hatched area (area, perimeter, centre of 
gravity, moments of inertia, direction of the main inertia axes). 


prim: a point near the hatched area, 
ENTER: completes the selection of hatched areas. 


Displays the text of user icon commands and user defined menus 
and icons. 


Displays the last created 20 objects which can be recalled by the 
UNDO command. 


Displays the number of Active, Modify Only (On) and Visible 
layers and the number of objects by layers. 


Displays the snap grid and the angle snap parameters. 
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?SYMBOL 


?7 TOLERANCE 


?VARTAB 


[SPREADSHEET file} { TOP | DETAILED } { DEFINED [ [SHORTLIST | 
WITHPARAMETER} select } 


Displays information about symbols on the highest or all levels 
which are defined or are in the selected set of symbols. 


SPREADSHEET: 
file: 

TOP: 
DETAILED: 
DEFINED: 


SHORTLIST: 


WITHPARAMETER: 
select: 


the data will be put into a file, 

the name of the file the data will be put into, 
the data of the symbols on the highest level 
will be displayed, 

the data of symbols on al! ievels will be 
displayed, 

the number of symbol occurences will be 
displayed, 

Lists the following data about the selected 
symbol: 

* name 

¢ symbol attributes with their values 

* symbol origin 

¢ translation vector 

e rotation angle 

* scale factors 

lists the selected symbols, 

pe crien of symbols whose data are to be 
isted. 


Displays information about the usable standard dimension 


tolerances. 


Displays the names of the defined simple variables and arrays, as 
well as the values of the simple variables and the dimensions of the 


arrays. 
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SAVE 


File/Symbol Operations 


{ SFILE | DRAW | ENVIRONMENT | DXF | IGES | PICT | ARCHICAD 
} ASCH | HPGL | ZFILE) { ENTER | file ) 


Saves the specified file into the current folder. 


SFILE: 


DRAW: 


DXF 

IGES 

PICT 
ARCHICAD 
ASCII 


HPGL 
ZFILE 


ENVIRONMENT: 


file: 


puts the symbols which are currently defined 
(in the memory) into a symbol file, 

puts the current alll into a drawing file 
in one of the following tile formats (or in 
topCAD’s own file format as the default): 


(topCAD’s file format for MS-DOS and UNIX 
environment), 


ZOOM, or 

saves the current environment (Preferred 
values, attribute values, user defined 
commands, etc.), 

the name of the file; if not specified, the last 
used file. 


Chapter 2: Detailed Description of Commands 


OPEN 


CLOSE 


MERGE 


{SFILE | DRAW | ENVIRONMENT | DXF 1 IGES | PICT | ARCHICAD | 
ASCII | HPGL | ZOOM | ZFILE{ZTOP | ZFRONT | ZSIDE] } { ENTER | 
file } 


Loads the specified file into the memory. 


SFILE: the symbols which are currently defined (in the 
memory} into a symbo! file, 
DRAW: the current drawing into a drawing file 


in one of the following file formats (or in 
topCAD’s own file format as the default): 


DXF 

IGES, 

PICT 

ARCHICAD 

ASCII (topCAD’s file format for MS-DOS and UNIX 
environment), 

HPCL, 

ZFILE ZOOM 

ZTOP: top view, 

ZFRONT: front view, 

ZSIDE: side view or 


ENVIRONMENT: environment (Preferred values, attribute values, 
user defined commands, etc.) 
file: the name of the file to open. 


{ YES | NO} 


topCAD closes the drawing window. The command needs a 
confirmation. If the answer is NO, it has no effect. 


( SFILE | DRAW} { ENTER | file } 


Loads a symbol file or drawing without deleting the current symbols 
or drawing respectively. The drawing file is merged without 
transformation. 


SFILE: symbol file 

DRAW: _— drawing file 

ENTER: merges the file of the last used filename 
file: the name of the file to merge. 
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POSITION SYMBOL = symb < coord > ENTER 


Positions the given symboi at the given locations using the 
Preferred transformation and text parameters. 


symb: the name of the symbol to be positioned, 
coord: the point where the origin of the symbol will be 
positioned, 


ENTER: completes the symbol positioning. 


POSITION DRAW file < coord > ENTER 


Positions the given drawing to the given location using the 
Preferred transformation. 


file: the name of the drawing file to be positioned, 
coord: the point where the origin of the drawing will be 
positioned, 


ENTER: completes positioning of drawings. 


SEARCHLIB = < file> ENTER 


Selects a set of symbol! files which will be searched for a symbol if 
the positioned symbo! is not present in the memory. 


file: symbol file name, 
ENTER: completes the selection of files. 


CATALOGUE ENTER 
Lists the current folders, files and autosave files for symbol 


libraries, drawings, macros, scan and list files, plotter files. tt also 
lists the set of symbol libraries selected for searching. 
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CATALOGUE SYMBOL 


CATALOGUE 


ERASE SYMBOL 


ERASE 


[ {DETAILED | ALL} } {symb | ENTER } 


Prepares a catalogue of the defined symbols (wildcards are 
allowed). 


DETAILED: lists the defined symbols, 

ALL: lists the defined symbols showing the number of 
comprising objects, 

symb: the name of the symbol! to be listed, 

ENTER: all defined symbols will be listed. 


{SFILE | DRAW | ENVIRONMENT | MACRO } (ENTER ! file } 


Prepares a Catalogue of the given type of files (wildcards are allowed). 


{ ENTER | symb ) { YES | NO} 

Deietes one or more symbols (wildcards are allowed). The 
command needs a confirmation. If the answer is NO, it has no 
effect. 


ENTER: — deletes all defined symbols from the memory, 


symb: the name of the symbol to be deleted, 
YES: the symbol(s) wil! be deleted, 
NO: the command will be cancelled. 


{ SFILE | DRAW | ENVIRONMENT | MACRO } { ENTER | file } { YES | 
NO } 


Deletes one or more files of the given type (wildcards are allowed). 
The command needs a confirmation. If the answer is NO, it has no 
effect. 


SFILE: symbol! file, 

DRAW: drawing file, 

ENVIRONMENT: — environment file, 

MACRO: macro, 

ENTER: all files of the given type will be deleted, 
file: name of the file to be deleted, 

YES: the specified files will be deleted, 

NO: the command will be cancelled. 
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RENAME SYMBOL = symb1_ symb2 
Renames a symbol. 


symb1: — the symbol name to be changed, 
symb2: = the new symbo! name. 


“ 


RENAME = _{ SFILE 1 DRAW | ENVIRONMENT | MACRO } filet file2 


Renames a file of the given type. 


SFILE: symbol file, 

DRAW: drawing file, 

ENVIRONMENT: = environment, 

MACRO: macro, 

file1: name of the file to be renamed, 
file2: the new filename. 


UNLINK <prim > ENTER 


Decomposes a symbol, a hatch, text or a dimension into separate 
objects. 


prim: a point near the object to be unlinked, 
ENTER: completes the command. 


UNLINK SELECT <select > ENTER 


Decomposes a set of symbols, hatches, text or dimensions into 
separate objects. 


select: the selection of objects to be unlinked, 
ENTER: completes the command. 


PURGE {YES ! NO} 


Deletes all unused symbols from the memory. The command needs 
a confirmation. tf the answer is NO, it has no effect. 
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RESOLVE 


ADDSYMB 


FOLDER 


OPENPRINT 


{ ENTER | file } 


Attempts to absolve the unresolved symbol references using the 
given or the default symbol file. 


ENTER: searches the default symbol file for the unresolved 
symbols, 

file: the name of the file to search for the unresolved 
symbols. 


{ ENTER | symb } { ENTER ! file } 

Adds one or more symbols into a symbol! file. 
ENTER: the last used symbol! will be added, 
symb: the name of the symbol to be added, 


ENTER: the symbol will be added to the default symbol file, 
file: the name of the file to which the symbol will be added. 


{ SFILE | ORAW | ENVIRONMENT | MACRO }) text 


Sets the current folder for symbol files, drawings, environments, or 
macros. 


SFILE: symbol! file, 
DRAW: drawing file, 
ENVIRONMENT: = environment file, 
MACRO: macro, 

text: the folder name. 
file 


Opens the specified file for writing. 
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PRINTF file < text? < {num | text2 } > > ENTER 


’ Outputs a set of numerical or textual values into a file. 
file: the name of the file, 
text1: the format fist {it can be a multiline text): 


%d means an integer value, 
%f means a floating point value, 
%x means a hexadecimal integer value, 
%O means an octal integer value, 
%c means a character, 
%5 means a textua! value from the current 
position to the next space " ", 
%| means a textua! value from the current 
position to the end of the line, 
(it is similar to the printf command of the C language) 
num: numerical value to be written into the file, 
text2: textual value to be written into the file, 
ENTER: completes the command. 


OPENSCAN file 


Opens the specified file for reading. 


SCANF _ file < text] < var > > ENTER 


Reads a set of numerical or textual values from a file. Each line of 
the format text is assigned to a line of the scan file. 


file: the name of the file, 
text1: the format list (it can be a multiline text): 
%d means an integer value, 
%f means a floating point value, 
% x means a hexadecima! integer value, 
%O means an octal integer value, 
%C means a character, 
%s means a textual value from the current 
position to the next space “ ”, 
%| means a textual value from the current 
position to the end of the line, 
(it is similar to the printf command of the C language) 
var: variable to which the value read from the file will be 
assigned, 
ENTER: completes the command. 
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CLOSEFILE 


LISTFILE 


LIST 


FONTDEF 


file 


Closes the specified file. 


{ON | OFF} 


Following a /LISTFILE ON command the output of the /LIST 
command and the query commands (starting with "?") are put into a 
file in the List folder until the next /LISTFILE OFF command. The 
next /LISTFILE ON command opens the next file. The files are 
named toptistO, toptisti, ... . 


< text! < {num | text2 } > > ENTER 


text1: the format list (it can be a multiline text): 

%d means an integer value, 

Yf means a floating point value, 

%s means a textual value, 

(it is similar to the printf command of the C language) 

num: numerical value to be written into the file, 
text2: textual value to be written into the file, 
ENTER: completes the command. 


num < char [BOUNDS naum1 num2 num3 num/4! select > 


Defines a character of the user defined font numbered num.:The 
character bounds can also be set. 


num: the font number, 

char: the original character of the given font representing the 
defined character, 

BOUNDS: the boundary of the defined character will be specified 
(the normal boundary is a 100°100 rectangle), 

num: top limit (1 through 150), 

num?2: bottom limit (-50 through 99}, 

num3: right limit (1 through 150), 

num4: left timit (-50 through 99), 

select: selects the object representing the character. 
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Attribute Definitions 


TOLERANCE num 


Sets the radius of the tolerance circle in % of width of the drawing 
window. 


SCREENSAVE {ON | PART | OFF} 
Sets the screen saving mode. 


ON: The entire drawing window is saved in memory. The 
drawing will reappear immediately after closing a dialog box 
or sacar Diels another application. It needs the most 
memory (about 250 KB for the 480 x 640 pixel, color 
monitor) but ensures the fastest operation. 


PART: Only the part of the drawing window covered by a dialog 
box will be saved. When you close the dialog box, the 
covered pan of the drawing will reappear immediately. 
However, if you move the command window or return 
from another application, the entire drawing window will be 
redrawn. This option provides a good balance between 
increased performance and minimal use of memory. 


OFF: No screen saving occurs. Not recommended when you 
work under MultiFinder. 


UNIT {(MMICMI!M} 


Sets the default drawing unit. All numerical values of length and 
coordinates will be interpreted and displayed in this unit. 
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AUNIT 


SNAP 


ASNAP 


{ DECIMAL | DMS } 


Sets the default angle unit. All angle values and dimensions wil! be 
displayed in this unit. 


DECIMAL: angle dimensions (fractions of degrees) in decimal units, 
DMS: angle dimensions (fractions of degrees) in minutes and 
seconds. 


{ length? { ENTER | fength2 { ENTER | length3 { ENTER i length4 } } } | 
ON | OFF | GRID num } 


Sets the parameters of the snap grid or chooses one of the grids to 
be used as a snap grid. 


lengtht: | snap grid horizontal step, 

ENTER: keeps the snap grid vertical step, 
length2: snap grid vertical step, 

ENTER: keeps the snap grid horizontal offset, 
length3: = snap grid horizontal offset, 

ENTER: = keeps the snap grid vertical offset, 
fength4: = snap grid vertical offset, 


ON: switches on the snap function, 

OFF: switches off the snap function, 

GRID: uses a grid asa phan ae 

num: the number of the grid to be used as a snap grid. 


{< angle > ENTER | HV | OFF | ON} 


Sets as many as eight snap angles or switches on/off the angie 
snap. 


angle: a snap angie, 

ENTER: completes entering snap angles, 

HV: sets the snap angles to 0°, 90°, 180°, 270°, 
OFF: switches off, 

ON: switches on the angle snap function. 
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AUTOSAVE {TIMEnum [| STEP num | OFF | ON } 
Specifies whether a temporary backup of the drawing should be 
automatically saved after a given time period or number of 
operations. 
TIME: automatic save after every num seconds, 
num: the time in seconds between two automatic saves, 
STEP: automatic save after every num operations 
num: the number of operations between two automatic saves, 


OFF: turn OFF the automatic save function, 
ON: | turn ON the automatic save function. 


JOURNAL {ON | OFF} 


Turns ON or OFF the journal file recording. 


LIKE = prim 


Sets all attribute values of the selected object at the current attribute 
values. 


prim: a point near the object. 


COLOR = { LIKE prim | num} 
Sets the current logical color number: 
LIKE: choosing the color of an existing object, 


prim: a point near the object; or 
num: a logical color number. 
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LTYPE 


LWIDTH 


{ LIKE prim | num } 

Sets the current line type: 

LIKE: choosing the line type of an existing object, 
prim: a point near the object; or 

mum: the number of a line type. 

The line type codes: 


1 





2 mmm ee 


7-128: are user defined line types 
(see Defining a custom line type at the description of 
the General command in section The Attributes Menu, 
chapter The Menu Commands in the User’s Guide). 


{ LIKE prim | length | FINE | NORMAL } 

Sets the current line width: 

LIKE: choosing the line width of an existing object, 
prim: a point near the object; or 

num: the number of a fine width. 


(the input is in the default length unit), or 
switches the drawing of wide lines between 


FINE: draws rounded ends (this takes more time), and 
NORMAL: draws square ends. 
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ULINETYPE < mum > ENTER 


Defines a new user line type {lines and gaps in % of width of the 
drawing window, max. 8 values). 


num: values for line or gap lengths, 
ENTER: completes entering values. 


CHEIGHT {LIKE prim | length} 
Sets the current character height for text and dimension text: 
LIKE: choosing the character height of an existing object, 


prim: a point near the object; or 
length: the value for the character height. 


CWIDTH ~~ {LIKE prim i num | PROPORTIONAL | FIXWIDTH } 


Sets the character width: 


LIKE: choosing the character width of an existing 
object, 

prim: a point near the object; or 

num: the character width in % of character height, 

PROPORTIONAL: each character has its individual width, 

FIXWIDTH: all letters have the same width. 


CGAP {LIKE prim | num } 
Sets the gap between characters: 
LIKE: choosing the gap of an existing object, 


prim: a point near the object; or 
num: a numerical value for the gap in % of character height. 
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LGAP 


CFONT 


TDIRECTION 


CSLANT 


{ LIKE prim | num } 
Sets the gap between the text lines: 
LIKE: choosing the gap of an existing object, 


prim: a point near the object; or 
mum: a numerical value for the gap in % of character height. 


{ LIKE prim | num } 

Sets the current font: 

LIKE: choosing the font of an existing text or dimension text, 
prim: a point near the text; or 


num: a numerical value for the font number in the range 
0-255. 


{ LIKE prim | angle } 
Sets the current text direction: 
LIKE: choosing the direction of an existing text or dimension teat, 


prim: a point near the text; or 
angie: an angle value for the text direction. 


{ LIKE prim | angle } 

Sets the current character slant relative to text direction: 

LIKE: choosing the slant of an existing text or dimension text, 
prim: a point near the object; or 


angle: an angie value for the character slant in the range 
15° -165°. 
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TORIGIN ~—= { LIKE prim | num } 
Selects the text origin: 


LIKE: choosing the origin of an existing text, 
prim: a point near the text; or 
num: a value specifying the text origin: 


lower left corner, 
mid-left, 

upper left corner, 
mid-bottom, 
centre, 

mid-top, 

lower right corner, 
mid-right, or 

upper right corner. 


Con rnin sh Wh — 


JUSTIFY — {LIKE prim | LEFT | CENTRED | RIGHT} 


Sets the current justification for multiline text: 


LIKE: choosing the justification of an existing text, 
prim: a point near the text; or 

LEFT: selects left justification, 

CENTERED: _ selects centered justification, 

RIGHT: selects right justification. 


HOFFSET {LIKE prim | length } 


Sets the current hatch offset (distance between the hatch lines or 
symbols): 


LIKE: choosing the offset of an existing hatch, 


prim: a point near the hatch; or 
length: a value for the offset. 
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HSTEP 


HDIRECTION 


PRECISION 


NODES 


{ LIKE prim | length } 


Sets the current hatch step (distance between the hatching 
symbols): 


LiKE: choosing the step of an existing symbol hatch, 


dab a point near the symbo! hatch; or 
ength: a value for the step. 


{ LIKE prim | angle } 


Sets the current hatch direction (direction of hatch lines or columns 
of symbols): 


LIKE: choosing the direction of an existing hatch, 


prim: a point near the hatch; or 
angle: a value for the direction. 


{ LIKE prim | num } 
Sets the current accuracy of splines: 
LIKE: choosing the accuracy of an existing spline, 


prim: a point near the spline; or 
num: a value for the accuracy. 


{ON | OFF} {ALL | ENTER | < { SSPLINE |! SPOLYLINE | STEXT | 
SSYMBOL | SCIRCLE | SCARC | SELLIPSE | SEARC | SHATCH | SLINE 
| SDIMENSION } > ENTER } 


Switches ON/OFF displaying the markers of the nodes or the 
special points of the selected class of objects. 
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DIGITS 


ADIGITS 


DSCALE 


{ LIKE prim | num } 

Sets the current number of decimal digits in the dimension numbers: 
LIKE: choosing the decimal digit number of an existing dimension, 
prim: a point near the dimension; or 

num: a value for the decimal digit number. 


Negative values lead to the suppression of displaying the zero 
value decimals. 


( LIKE prim | num } 

Sets the current decimal digit number in the angle quotations: 

LIKE: choosing the decimal digit number of an existing angle 
dimension, 

prim: a point near the angle dimension; or 

num: a value for the decimal digit number. 


Negative values lead to the suppression of displaying the zero 
value decimals. 


{ LIKE prim i num) 
Sets the current scale factor for dimensions: 
LIKE: choosing the scale factor of an existing dimension, 


prim: a point near the dimension; or 
num: a numerical value for the scale factor. 
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MKIND 


MSIZE 


{ LIKE prim { num} 


Selects the current marker type at the ends of a dimension line: 


LIKE: choosing the marker type of an existing dimension, 
prim: a point near the dimension; or 
mum: a numerical value for the marker type ranging 

from 0 through 3: 





{ LIKE prim | bength ) 
Sets the size of the markers at the ends of the dimension lines: 


LIKE; choosing the marker size of an existing dimension, 
rim: a point near the dimension; or 
fength: a numerical value for the marker size. 
Negative values lead to mirroring of the arrows by the 
extension fine. 
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DFORMAT 


DAFORMAT 


{ LIKE prim | text } 

Sets the format of the dimension text: 

LIKE: choosing the format of an existing dimension, 
prim: a point near the dimension; or 

text: a text to be part of the dimension text. 


The “#" character represents the measured value, the "“" character 
means the symbolic value of the UNI tolerance if it is present. 


Eg: /DFORMAT "Diameter = # mm"; 
The dimension text will be (the dimensioned size is 10.06 


min): 
Diameter=10.00 mm 


{ LIKE prim | text } 

Sets the format of angle quotations: 

LIKE: choosing the format of an existing angle dimension, 
prim: a point near the dimension; or 

text: a text to be part of the dimension text. 


The "#" character represents the measured value. 
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DTOLERANCE 


DATOLERANCE 


DTCOLOR 


{ ENTER | {LIKE prim1 | text? } {ENTER ! LIKE prim2 | text2 } } 


Sets the text of tolerances of the length quotations. ‘Both tolerances 
(upper and lower) can inherit the tolerance text of an existing 
dimension or can be entered as a text. ENTER means both tolerance 
texts or the lower one will be cleared. If the first text is identical to 
one of a standard tolerance and the second one is empty, the 
program will replace them with the correct computed values. 


ENTER: resets tolerance format (no tolerance values displaved 
in length dimensions); 


LIKE: defines the format of tolerance as that of an existing 
dimension, 

primt: a point near the object with the tolerance format to be 
picked up; 

textT: upper tolerance text, 


ENTER: resets tolerance format to display no lower tolerance 
values in length dimensions; 


LIKE: defines the format of lower tolerance as that of an 
existing dimension, 

prim2: a point near the object with the tolerance format to be 
picked up; 

text2: lower tolerance text. 


{ ENTER | ( LIKE prim1 | text? } (ENTER | LIKE prim2 | text2 } } 
Selects the text of tolerances of angle quotations. Both tolerances 
{upper and lower) can inherit the tolerance text of an existing 


dimension or can be entered as a text. ENTER means both tolerance 
texts or the lower one will be cleared. 


{ LIKE prim | num } 
Sets the logical color number for dimension text: 
LIKE: choosing the logical color number of an existing object, 


prim: a point near the chosen dimension; or 
num: a numerical value in the range of O ... 255. 
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DTLWIDTH 


PROJLINE 


TLAYER 


FSPECIAL 


{ LIKE prim | length } 
Sets the line width for dimension text: 


LIKE: choosing the fine width of an existing object, 
rim: a point near the chosen dimension; or 
ength: a numerical value in the range of 0 ... 25.5 mm. 


(Note that the input is in the default length unit). 


{ LIKE prim | length | NO } 
Sets the iength of the projection lines _ 


LIKE: choosing the line width number of an existing object, 
prim: a point near the dimension with the extension line width to 
be picked up; or 
length: length>0: 
projection lines start from the point to be dimensioned, 
length<0: 
projection lines start from the marker, 
NO: no projection line will be drawn. 


{ ACTIVE | ORIGINAL } ou 
Determines whether copied objects are assigned to 


ACTIVE: all ACTIVE layers 
ORIGINAL: — only the original layer (on which they exist). 


{ON | OFF} {ALL | ENTER | < { EXTREMUM | CENTER | MIDDLE | = 
FOCUS | INTERSECTION | NEAREST } > { ENTER | SSYMBOL | SHATCH } 


Switches on/off automatic gravity for the selected type of special 
point. Automatic gravity means that if a special point falls within the 
pointer tolerance radius, topCAD uses the coordinates of that 
point as the coordinates for a new point. Gravity can be switched 
off separately for symbols and hatches. 
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FIEXT {ON | OFF} 


Switches on/off the fast text drawing mode. ff ON, all text is 
replaced by rectangular frames. 


SYMBPAR num text 


Assigns the given text as a value to the $num textual symbol 
parameter. 


num: number of the symbol attribute (1 ... 8), 
text: the text value for the attribute. 


SYMBPAR {ON | OFF | FORMAL ) 


Determines whether or not text attributes of symbols appear on the 
screen with their current values. The attributes are displayed 


ON: by their values, 
FORMAL: by their names ($1 ... $8), 
OFF: they will not appear in the drawing. 


SYMBNPAR num num 


Assigns the given number as a value to the #num numerical symbol! 
attribute. 


num: number of the symbol attribute (1 or 2), 
num: the value for the attribute. 
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SYMBNPAR 


SYMBTEXT 


ATEXT 


ANGLE 


RADIUS 


MAJOR 


{ON | OFF | FORMAL } 


Determines whether or not numerical attributes of symbols appear 
on the screen with their current value. The attributes will be 
displayed: 


ON: by their values, 

FORMAL: by their names (#1, #2), 

OFF: they will not appear in the drawing. 
text 


Assigns the specified text as a comment for symbols. 


text 


Sets the Preferred text. 


angle 


Sets the Preferred direction. 


length 


Sets the Preferred radius. 


length 


Sets the Preferred major half axis. 
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MINOR 


{ ABEGIN | AEND } 


REPEAT 


AXFORM 


LXFORM 


length 


Sets the Preferred minor half axis. 


angle 


They set the Preferred end angles. 


num 


Sets the Preferred repeat factor. 


{ON i OFF | XCENTER | tran} 


Sets the Preferred transformation, turns the transformation om or 
off or switches on the transformation of the centrepoint of the 
object. All measurements are made trom the drawing origin 
(absolute coordinates). 


ON: switches on the current transformation 

OFF. switches off lignares) the current transfurmation 

XCENTER: switches on the transformation of the centrepoint of the 
object 

tran: sets the Preferred transformation 


(the validity of this setting is PERMANENT) 


in the absoiute system of coordinates, 


{ON | OFF | tran} 


Sets a temporary transformation in the object-dependant system o* 
coordinates (the validity of this setting is TEMPORARY), 


ON: switches on the temporary transformation, 
OFF: = switches off the temporary transformation 


in ifs OWN system of Coordinates. 
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GLOBAL 


ATTRIBUTES 


ATTRIBUTES DEFAULT 


DEFATTRIBUTES 


attribute_seting 


Detines the following attribute settings as PERMANENT. 


{PUT | GET} { ALL | ENTER | GENATTR | TEXTATTR | DiMATFR } 
{STACK | num } 


Saves/reads back the general, text, dimension, hatch and symbol 
attributes and the Preterred values into/from the selected memory 
cell (0... 9). 


{ ALL | ENTER | GENATTR | TEATATTR | DIMATTIR } 


Sets the general and/or the text- and/or the dimension attributes to 
the detault values. 


{ SSPLINE | SPOLYLINE | STEXT | SSYMBOL | SCIRCLE | SCARC | 
SELLIPSE | SEARC | SHATCH | SLINE | SDIMENSION | SPOINT } 
rum 


Selects a memory cell of attributes (0, .... 9) to store the current 
attributes. These attributes will be assigned to the objects created 
following this command . It the numerical value is -1, the attributes 
wili not be changed. 
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EXTREMUM 


CENTER 


Parameter Definitions 


Point Definitions 


in the case of keyboard input topCAD uses the entered lengths as 
x and y coordinates. The RECALL command may also be used. 


prim 


The nearest endpoint of the object: 


(AOE 
G 


~¢ py text Ms 


prim: a point near the object. 


C 
S 


prim 


The nearest centrepoint of the object: 


LAAILOE 
2) 


“27 text 8s 


prim: a point near the object. 
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MIDDLE prim 


The nearest midpoint of the object: 


fl OC OE 
“ey text ree J 


prim: a point near the object. 


FOCUS prim 


The nearest focal point of the object: 


FiO Ort 
Pp text oes JY 


INTERSECTION prim’ prim2 
The intersection point of the two objects closest to the given point. 
If there is no real intersection point between the two objects, 
topCAD tries to extend the objects. 


primi: a point near one of the objects, 
prim2: @ point near the other object. 
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MINTERSECTION 


[x] 
LY] 


POLAR 


[Dx] 
[DY] 


DPOLAR 


prim 


The intersection point of the selected object closest to the given 
DOIN. 


prim: a point near the object. 


length1 
length2 


Defines by absolute Cartesian (orthogonal) coordinates 


length!: — the x coordinate of the point, 
length2: — the y coordinate of the point. 


length angle 
Defines a point by absolute polar coordinates. 


sil the length coordinate of the point, 
angle: the angle coordinate of the point. 


length1 
length2 


Defines a point by Cartesian (orthogonal) coordinates relative to the 
recently entered point. 


lengtht: — the relative x coordinate of the point, 
length2: — the relative y coordinate of the point. 


length angle 


Defines a point by polar coordinates relative to the recently entered 
point. 


length: the relative length coordinate of the point, 
angle: the relative angle coordinate of the point. 
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CXLATED 


CXPOLAR 


CXFORMED 


NEAREST 


CDIVIDED 


length1 length2 coord 
Defines a point by orthogonal coordinates relative to the given one. 
lengthi: the relative x coordinate of the point, 


length2: the relative y coordinate of the point, 
coord: the reference point. 


length angle coord 
Defines a point by polar coordinates relative to the given one. 
length: the relative Jength coordinate of the point, 


angle: the relative angle coordinate of the point, 
coord: the reference point. 


trans coord 


Defines a point by transformation of the coordinates of the given 
one. 


trans: the transformation defining the point, 
coord: the reference point. 


prim 
The closest point of the object to the given point. 


prim: a point near the object. 


num prim 


Defines a point dividing the object according to the given 
proportion from the endpoint nearer the given point. The result will 
be the dividing point. 


num: the dividing proportion (0 ¢ num ¢ 1), 
prim: a point near the object. 
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CDISTANCE 


MDISTANCE 


ORIGO 


--- BOTTOMLEFT 


TOPRIGHT 


CRICENTER 


length prim 

Defines a point measuring the given distance et the object from 
the endpoint nearer the given point. The result will be the dividing 
point. 

length: the distance of the dividing point from the endpoint nearer 


the picked point, 
prim: a point near the object. 


length prim 


Defines a point measuring the given distance along the object from 
its midpoint. The result will be the dividing point. 


length: the distance of the dividing point from the midpoint, 
prim. @ point near the object. 


Defines a point at the origin of the coordinate system. 


Defines a point at the bottom left corner of the drawing window. 


Defines a point at the top right corner of the drawing window. 


Defines a point at the centre of the drawing window. 


Point Definitions 


USE var 


Defines a point using the coordinate values stored in the given 
variable. 


var: the name of the variable. 


138 Chapter 2: Detailed Description of Commands 


PERIMETER 


Length Definitions 


In the case of keyboard input, topCAD uses the entered jiength. 
The RECALL command may also be used. 


prim 


Defines a length as the tota! length or the perimeter of the selected 
object: 


Point: 

line: 
polyline: 
circle: 
circular arc: 
ellipse: 
elliptic arc: 
spline: 
text: 
dimension: 
hatch: 


Zero, 

jength, 

the total length, 

the perimeter, 

the perimeter, 

the perimeter, 

the perimeter, 

the total iength, 

the perimeter of the enclosing rectangle, 
the dimensioned size, 

the offset (the distance between the lines): 


t/N © JO W7n FA 


prim: 


a point near the object. 
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SIZE 


LOISTANCE 


LSCALED 


prim 


Defines a length as the characteristic size of the selected object: 


e point: zero, 

e line: length, 

e polyline: the length of the selected part, 
e circle: radius, 

® circular arc: radius, 

e ellipse: half major axis, 

e elliptic are: half major axis, 

e spline: the length of the selected part, 
© text: character height, 

* dimension: the dimensioned size, 

e hatch: the offset (the distance between the lines): 


t/N OISR) 41 fs, 


prim: a point near the object. 


coord! coord2 
Defines a length as the distance between two selected points. 


coord: one of the points, 
coord2: = the other point. 


num length 
Defines a length as the given length multiplied by the given number. 


num: the multiplication factor, 
length: the length to be multiptied. 
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ACCUMULATED 


REDUCED 


xc 


YC 


USE 


< length > ENTER 
Defines a length as the sum of the given lengths. 


length: @ length to add, 
ENTER: completes the collection of lengths to be summarized. 


length < length2 > ENTER 


Defines a length as the difference between the first length and the 
sum of ali other fengths: length=length1-(length2+length2+ ...). 


length1: — the length given first, 


length2: — lengths to be summarized and subtracted from length1. 
ENTER: completes the collection of the latter. 


coord 
Defines a length as the x coordinate of a point. 


coord: the point whose x coordinate will be used. 


coord 
Defines a length as the y coordinate of a point. 


coord: the point whose y coordinate will be used. 
var 


Defines a length using the length value stored in the given variable. 


var: the name of the variable. 
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APARALLEL 


APERPENDICULAR 


AROTATED 


ADIVIDED 


Angle Definitions 


In the case of keyboard input, topCAD uses the entered angle. The 
RECALL command may also be used. 
prim ™ 


Defines an angie as the angle of the selected object (or its tangent) 
at its Nearest point to the given point. 


prim: a point near the object whose angle is to be used. 


prim 


Defines an angle adding 90° to the angle of the selected object (or 
its tangent) at its nearest point to the given point. 


prim: a point near the object whose angle is to be used. 


angle prim 


Defines an angle adding the defined angie to the angie of the 
selected object (or its tangent) at its nearest point to the given point. 


angle: the rotation angle, 
prim: a point near the object whose angle is to be used. 


num angle 
Defines an angle dividing the specified angle by the given number. 


num: the divider, 
angle: the angie to be divided, 
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ASTRUCTURED prim 


The characteristic angle of the object: 


OCA & 
ext ree J @ 


prim: a point near the object whose characteristic angle is to be 
used. 


AINTERSECTION  prim1 prim2 


Defines an angle as the angle between the tangents of two 
intersecting objects at their intersection point closest to the given 
points. If there is no intersection point between the two objects, 
topCAD tries to extend the objects. The angle is in that fragment of 
the plane where the first point is located. 


prim1: a point near one of the intersecting objects, 
prim2: a point near the other object. 


AMINTERSECTION prim 
Defines an angle as the angle between the tangents of the selected 
object and another one which intersects the first object closest to 
the given point. The angle is measured at the intersection point in 
that fragment of the plane where the first point is located. 


prim: a point near the object. 
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AGRAPHIC 


USE 


coord! coord2 coord3 

Defines an angle by the vertex and by a point in each boundary. 
For exact definition the point definition commands (Vertex, Nearest 
Point, Intersection etc.) must be used. 


3 


ca 


2 


coord1: the vertex of the angle, 
coord2: a point in one of the boundaries, 
coord3: a point in the other boundary. 


var 
Defines an angie using the angle value stored in the given variable. 


var: the name of the variable. 
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= CONCATENATED 


MULTILINE 


TREPEAT 


Text Definitions 


in the case of keyboard input, the text typed in. The RECALL 
command may also be used. 


Any text containing the space “", or any other specia! characters 
must be entered between """ characters. 

< text > ENTER 

Defines a text joining the entered text strings. 

text: a text string which will be a pan of the concatenated 


text, 
ENTER: completes entering strings. 


< text > ENTER 


Defines a multiline text. Each entered text string will be a separate 
line in the multiline text. 


text: a text string which will be a part of the multiline text, 
ENTER: completes entering strings. 


num text 
Defines a text repeating and joining the entered text num times. 


num: the number of repetitions, 
text: a text string to be multiplied. 
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SUBTEXT 


TFILE 


TDATE 


TTiME 


EXISTING 


USE var 


text num? num2 


Defines a text containing the part of the specified text from the 
numst character up to the num2nd one. 


text: the specified text, 
mum: the sequence number of the first required character in the 
specified text, 


num2: the sequence number of the last required character in the 
specified text. 


file 
Defines a text as the contents of a file. 


file: the name of the file containing the text. 


Defines a text as the current date. 


Defines a text as the current time. 


prim 
Defines a text as the selected one. 


prim: a point near the text. 


Defines a text using the text stored in the given variable. 


var: the name of the variable. 
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XLATE 


XLATE XY 


XLATE XPOLAR 


ROTATION 


Transformation Definitions 


The RECALL command may also be used. 


coord? coord2 
Defines a shift specifying a point and a new position for it. 


coord?: the point to be moved, 
coord2: the new position of the moved point. 


length1 length2 
Defines a shift vector by its horizontal and vertical components. 


lengtht: the horizontal! offset, 
length2: the vertical offset. 


length angle 


Defines a shift vector by its length and angle. 


length: the length of the offset, 
angle: the angle of the offset. 
coord 


Defines a rotation around the given point by the Preferred angle. 


coord: the rotation centre. 
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ROTOTRANS 


MIRROR 


MIRROR ITEM 


coord! coord2 coord3 coord4 


Defines a shift and a rotation. The shift vector starts from the first 
point and ends at the third point. The angle of rotation is the 
difference between the angles of the segments 3-4 and 1-2, the 
centre of rotation is the first point. 


—"2 


1 


3 


coord1: a point to be moved (also serves as the rotation 
centre), 
coord2: the second point to be moved, 
coord3: — the endpoint of the shift vector i.e. the new position for 
oint 1, 
coord4: veal which defines the angle of the segment 1-2 after 
the transformation. 


coord! coord2 
Defines a mirroring by the axis determined by the two points. 


coord1: =a point of the mirroring axis, 
coord2: another point of the mirroring axis. 


prim 

Defines a mirroring by the given object. The object may be a point 
(rotation around this point by 180°), a line or a polyline (the part of 
the polyline closest to the pick). 


prim: a point near the mirroring object. 
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XSCALE 


XSCALE 


LRATIO 


num coord 
Defines a scaling by the given factor and the given centre. 


num: the scaling factor, 
coord: the centrepoint of scaling. 


{X 1 ¥} num coord 


Defines a horizonta! (or vertical) only scaling by the given factor 
and the given centre. 


x: horizontal only scaling, 
Y: vertical only scaling, 
num: the scaling factor, 

coord: the centrepoint of scaling. 


length length2 coord 


Defines a scaling by the given centre with a 
scaling factor equal to the ratio length] /length2. 


length1: and 
length2: = numbers defining the scaling factor, 
coord: the centrepoint of scaling. 
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BOX XLATE coord? { coord2 | BOXSIZES length1 length2 } { coord3 | XOFFSET 
length3 lengtha } 


Defines a shift as well as a window for the MOVE PART, MOVE 
CONTINUOUS, STRETCH etc. commands. Instead of the 
coordinates it is possible to enter the absolute sizes of the box and 
the offset vector. 


coord!: a corner of the window (the starting point of the 
movement vector), 

coord2: the opposite corner of the original window; or 

BOXSIZES: the window size will be given, 

fengthi: the horizontal size of the window, 

length2: — the vertical size of the window; 

coord3: the new position of the first corner of the window (the 
endpoint of the movement vector); or 

XOFFSET: the movement will be defined by its horizontal and 
vertical components, 

Jength3: = the horizontal component of the movement vector, 

length4:; — the vertical component of the movement vector. 


Chapter 2: Detailed Description of Commands 


BOX XSCALE 


coord! { coord2 | BOXSIZES length1 fength2 } { coord3 | XOFFSET 
length3 lengths } { coord4 | XFACTOR num ) 


Defines a shift and a scale as well as a window for the MOVE 

PART, MOVE CONTINUOUS, STRETCH etc. commands. instead of 
the coordinates it is possible to enter the absolute sizes of the box 
and the offset vector. it is also possible to enter the correct scale 
factor numerically. 


coord!: — a corner of the original window (the starting point of the 
movement vector), 

coord2: the opposite corner of the original window; or 

BOXSIZES: the window size wiil be given, 

lengtht: — the horizontal size of the window, 

length2: — the vertical size of the window; 

coord3: — the new position of the first corner of the transformed 
window (the endpoint of the movement vector); or 

XOFFSET: the movement will be defined by its horizonta! and 
vertical components, 

fength3: — the horizontal component of the movement vector, 

lengih4: — the vertical component of the movement vector; 

coord4: = the new position of the opposite corner of the 
transformed window; or 

XFACTOR: the scaling will be defined numerically, 

num: the scale factor. 


Transtormation Definitions 157 


BOX ROTATION coord! { coord2 | BOXSIZES length1 length2 } { coord3 | XOFFSET 
length3 length4 } { coord4 | XANGLE angle } 


Defines a shift and a rotation as well as a window for the MOVE 
PART, MOVE CONTINUOUS, STRETCH etc. commands. Instead of 
the coordinates it is possible to enter the absolute sizes of the box 
and the offset vector. The correct angle value can also be entered. 


coord!: a corner of the original window (the starting point of the 
movement vector), 

coord2: the opposite corner of the original window; or 

BOXSIZES: the window size will be given, 

length}: — the horizontal size of the window, 

length2: _—_ the vertical size of the window; 

coord3: the new position of the first corner of the transformed 
window (the endpoint of the movement vector); or 

XOFFSET: the movement wil! be defined by its horizontal and 
vertical components, 

length3: the horizontal component of the movement vector, 

lengthé: — the vertical component of the movement vector; 

coord4: = the new position of the opposite corner of the 
transformed window; or 

XANGLE: the rotation will be defined numerically, 

angle: the rotation angle. 
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BOX ROTOTRANS 


coord! { coord2 | BOXSIZES length! length2 } { coord3 | XOFFSET 
length3 length4 } { coord4 | XFACTOR num [XANGLE] angle | 
XANCLE angle [XFACTOR] num } 


Defines a shift, a rotation and a scaling as well as a window for the 
MOVE PART, MOVE CONTINUOUS, STRETCH etc. commands. 
Instead of the coordinates it is possible to enter the absolute sizes 
of the box and the offset vector. The correct angle value and the 
scale factor can also be entered numerically. 


coord1: —a corner of the original window (the starting point of the 
movement vector}, 

coord2: the opposite corner of the original window; or 

BOXSIZES: the window size will be given, 

fength1: — the horizontal size of the window, 

fength2: — the vertical size of the window; 

coord3: the new position of the first corner of the transformed 
window {the endpoint of the movement vector); or 

XOFFSET: the movement will be defined by its horizontal and 
vertical components, 

length3: — the horizontal component of the movement vector, 

length4: — the vertical component of the movement vector; 

coord4: =the new position of the opposite corner of the 
transformed window: or 

XFACTOR: the scaling will be defined numerically, 


num: the scale factor; 
XANCLE: the rotation wil! be defined numerically, 
angle: the rotation angle. 
1 
4 
3 
2 
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IDENT 


MULTITRANS 


MATRIX 


USE 


Defines the coincidental transformation: 
® no translation, 


* no rotation, 
¢ scale factors=1. 


< trant, (tran2} ... > ENTER 
Combines the given transformations. 
tran1: definition of a transformation, 


tran2: definition of another transformation, 
ENTER: completes the definition of transformations. 


x11 x12 x13 x21 x22 x23 


Defines a transformation matrix by elements. 


Var 


Defines a transformation as the one stored in the given 
transformation type variable. 


var: the name of the variable. 
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SWINDOW IN 


SWINDOW OUT 


SWINDOW FRAME 


CHAIN 


Selection Definitions 


Selection Defining Commands 


coord! coord2 
Selects all objects located entirely inside a window. 


coord): a corner of the window, 
coord2: the opposite corner of the window. 


coord! coord2 
Selects all objects located entirely outside a window. 


coord!: a corner of the window, 
coord2: the opposite corner of the window. 


coord! coord2 


Selects all objects which have a common point with the frame of a 
window. 


coord!: a corner of the window, 
coord2: the opposite corner of the window. 


prim 

Selects all objects belonging to the selected chain. The chain must 
be closed. The way the objects are selected is similar to that in the 
HATCH CHAIN statement. 


prim: a point near an object in the chain. 
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INTCHAIN prim 


Selects all objects belonging to the selected chain or to one of its 
internal chains. The chains must be closed. The way the objects are 
selected is similar to that in the HATCH INTCHAIN statement. 


prim: a point near an object in the chain. 


OPENCHAIN prim 


Selects objects belonging to the selected open chain. 
The whole chain or a part of the chain can be selected: 


* pointing to the first or the last object in the chain nearer its free 
endpoint, the whole chain is selected, 

© pointing to the first or the last object in the chain nearer its 
endpoint connected to the next object, only that object is 
selected, 

¢ pointing to any other object in the chain, a part of the chain will 
be selected: from the chosen object to the end of the chain 
which is farther from the selected point than from the midpoint 
of the chosen segment. 


prim: a point near an object in the chain. 


ALL  { SPOINT | SLINE | SPOLYLINE | SCIRCLE | SCARC | SELLIPSE | 
SEARC | SSPLINE | STEXT | SDIMENSION | SHATCH | SSYMBOL | 
SITEM } ENTER 
Selects all visible objects of the given type. 

ENTER: cornpletes the selection. 


E.g.: /MOVE SELECT ALL SCIRCLE; 
Moves ail circles using the Preferred transformation. 
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SNAME 


EXCEPT 


AND 


BEGIN 


SLAYER ACTIVE 


symb 
Selects all positioned symbols with the given name. 


symb: the name of the symbol to be selected. 


select 
Excludes the selected set of objects from the selection. 


select: selection of the objects to be excluded. 


select 
Removes from the selection all objects not selected after the AND. 


select: selection of the objects. 


< select > ENTER 

Starts a new selection group. The consecutive EXCEPT and AND 
statements will not have any effect on the part of the selection 
entered before the BEGIN. 


select: selection of the objects. 


Selects all the objects located on active layer(s). 
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SLAYER SELECT set 
Selects all the objects located on one of the listed layers. 


Set: a set of layers. 


SLAYER NSELECT _ set 
Selects all the objects not located on any of the listed layers. 


set: a set of layers. 


SCOLOR [SELECT] _ set 
Selects all objects with one of the listed colors. 


set: a set of logical color numbers. 


SCOLOR NSELECT set 
Selects ail objects whose color is not on the list. 


set: a set of logical color numbers. 
SLTYPE [SELECT] set 


Selects all objects with one of the listed line types. 


set: a set of logical line type numbers. 
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SLTYPE NSELECT - 


SLWIDTH [SELECT] 


SLWIDTH NSELECT 


SLWIDTH INTERVAL 


SLWIDTH INTERVAL NSELECT 


set 
Selects ali objects whose line type is not on the list. 


set: a set of logical line type numbers. 


< length > ENTER 
Selects all objects whose line width is on the list. 


length: a line width value. 


< length > ENTER 
Selects all objects whose line width is not on the list. 


length: a tine width value to be excluded from the selection. 


< length! length2 > ENTER 


Selects al! objects whose line width is in one of the given line width 
ranges. 


length: the smailest required line width, 


length2. the largest required line width, 
ENTER: completes the definition of line width ranges. 


< lengtht length2 > ENTER 


Selects all objects whose line width is out of any of the given line 
width ranges. 


lengthi: — the smallest line width to be excluded, 


fength2. the largest line width to be excluded, 
ENTER: completes the definition of line width ranges. 
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ENTER 


End of the selection. 
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SPOINT 
SLINE 
SPOLYLINE 
SCIRCLE 

~ SCARC 
SELLIPSE 
SEARC 
SSPLINE 
STEXT 
SDIMENSION 
SHATCH 
SSYMBOL 


SITEM 


Selection Definitions by Object Types 


coord: a point near the object. 


Selects the object nearest to the point within the tolerance circle. 


‘ coord 


coord 
coord 
coord 
coord 
coord 
coord 
coord 
coord 
coord 
coord 
coord 


Selects the object nearest to the point within the tolerance circle. 
The object must be of the given type. 


coord: a2 point near the object. 


coord 


The command extends again the searching to all objects after an 
erroneous restriction of type. 


coord: a point near the object. 
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Programing Tools 





Numeric Expressions 

Functions 

Variables 

Assignment Statements 

Variable Definitions 
Variable Definition by Assignment Commands 
Variable Definition by Dialog Commands 

Assignation of Values to Variables 

Contro! Statements 

Parametric Macro/External Procedures 





165 
167 
168 
171 
171 
172 
180 
188 
189 
197 


This group of commands and other tools is slightly different from 
the others.This group of commands does not describe what to do 
but instead how to interpret commands; it can be mixed with any 


other group of commands. 


Numeric Expressions 


Numerical expressions can be entered any time the program 
expects a numerical value, a length, an angle or a coordinate. An 
expression is a chain of arithmetical operands and operators. There 
are only binary operators, the use of double operators is 


forbidden. 


The operators and their precedence: 


Group! 
Group2 


Group3 


Group4 


Group5 


Group6 
Group? 


Aor °* 


/ 
% 


+ 


<> or # 


Er 


power 


multiplication 
division 
modulo 


addition 
subtraction 


equal to 

not equal to 

less than or equal to 
less than 

greater than or equa! to 
greater than 


logical AND 

(the operand is TRUE, if#O, 
FALSE, if=0, 

the result is TRUE, if=1, 
FALSE, if=0) 


logical inclusive OR 


logical exclusive OR 
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Operators within one group are evaluated from the left to the right. 
The order of evaluation can be changed using parentheses. 


Operands can be decimal values, function calls with or without 
parameters, variable references. 


A decimal value can be a decimal number or an angle: 
decimal_number ~° [decimal_number ~'] (decimal_number [~"]] 


decimal_number =' [decimal_naumber {~"]] 
decimal_number ~" 


The format of the decimal number: 


digit <digit> [. <digit> ] {E [{ + | - }} digit <digit> ] . <digit> [E [f+ | - }} 
digit <digit>] 
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Possible function calls: 


ABS 
INT 
FRA 
SGN 
SQR 
ACS 
ASN 
ATN 
COs 
SIN 
TAN 
EXP 
LGT 
LOG 
NOT 


MAX 
MIN 
LEN 

POS 


P| 

REC 
RET 
ERR 
EOF 


(expression) 
(expression) 
(expression) 
(expression) 
(expression) 
(expression) 
(expression) 
(expression) 
(expression) 
(expression) 
(expression) 
(expression) 
(expression) 
(expression) 
(expression) 


(expression <, expression >) 
(expression <, expression >) 
(textual variable) 
(textual_variable, textual_variable) 


(filename) 
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the absolute value; 
the integer part; 
the fractional part; 
the sign function (return value is +1, 0, or -1); 
the square root function; 
the arc cosine function (result in degrees): 
the arc sine function (result in degrees); 
the arc tangent function (result in degrees); 
the cosine tunction {argument in degrees); 
the sine function (argument in degrees); 
the tangent function (argument in degrees); 
the exponential function; 
the ten-based logarithm; 
the natural logarithm; 
the logical NOT function. Returns 0 if the argument +0 
1 if the argument =0; 
the maximal value function; 
the minimal value function; 
the length of the text stored in the variable; 
the position of the text stored in the second variable in the 
text stored in the first variable. The first index is 1. If the 
second text is not present in the first one, the result is zero; 
the Ludolph's constant; 
the latest entered numerical value (recall function); 
the return code of the previously called procedure; 
non-zero if the last executed function failed, zero otherwise; 
returns = -1: if closed, 
0: if opened, 
1: at end of file. 
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Variables 


rr 


The seven possible variable types: 


integer, 

floating point, 
length, 

angle, 
coordinate, 
transformation, 
textual and 
system variables. 


A variable reference is 


e the name of the variable, 
¢ one or more indexes (if it is an array), and 
° a qualifier (if necessary). 


The number of the indexes and their upper limits are prescribed in 
a DIMARRAY statement. The lower limits are always 0. The indexes 
are ordinary numeric expressions. 


No qualifier is allowed after the name of an 


e integer, 

e floating point, 
e length and 

6 


angle type variable. 


The possible qualifiers after the name of a 
coordinate variable (the default is .L): 


Xx the x coordinate of the variable 

Y the y coordinate of the variable 

Lor.R the distance between the point and the origin 

A the angle between a line passing through the point 


and the origin, and the x-axis (in degrees) 
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The possible qualifiers after the name of a 
transformation variable (a qualifier must be used): 


17 
12 


.13: 


21 
22 


23: 


31 
BS 


nee I 


the first row of the transformation matrix, 


the second row of the transformation matrix, 


the third row of the transformation matrix (always 0,0,1}. 


.X or .DX The x coordinate of the translation component of the 


transformation. 


Yor .DY The y coordinate of the translation component of the 


transformation. 


“ 5X The x scale factor component of the transformation. 
SY The y scale factor component of the transformation. 
A The rotation angle component of the transformation (in 
degrees). 
Notes: 


A variable name may contain max. 20 characters, the first one 
is alphabetic, the others are alphanumeric characters. 


There is no difference between upper and lower case letters. 
Array variables must be declared in a DIMARRAY statement. 
The maximal number of indexes is 8. 
The indexes are enclosed in brackets. 


Only previously defined variables can be used in an arithmetic 
expression. 


Any length value is interpreted in the current length unit (for 
example, you have defined a coordinate value as (3m; 4m) and 
stored it in the variable "point1"; if the current unit is cm, the 
value of pointt.L is 500). 
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Eg: 

IVAL 

A simple variable without any qualifier. 
POINT.X 

The x coordinate of a coordinate type variable. 
FARR[I+7]}{J-3] 


An element of a matrix. The indexes also contain references to 
variables. 


XTRN(2°1).SX 


The scale factor of an element of a transformation vector. The index 
contains a variable reference as well. 
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Assignment Statements 


Variable Definitions 


Defining a variable, you should specify the type (by the keyword), 
the name and a value. 


You can change a part of a variable, for example, the x coordinate 
of a coordinate type variable. in this case a qualifier must follow the 
variable name. See possible qualifiers after each assignment 
statement. 


Two ways of variable definition are available: 


by assignment commands 
e.£.: 


/vint a1 123 
the value of the integer type variable will be 123 


/vfloat b2 123.456 
the value of the floating point type variable will be 123.456 


/viext mame2 "Connecting rod" 
the value of the text type variable will be Connecting rod. 


using a file: 

a dialog box appears containing the values in the specified file 
you can choose from. The file should be in the Current macro 
folder, otherwise the complete file specification must be given 
(drive:folder:filename). 


Any type of variables (except transformation) can be specified 


using a file. See section Variable definition using dialog 
commands later. 
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Variable Definition by Assignment Commands 


VINTEGER var num 


var: variable name, 
num: numerical value or expression. 


Assigns the integer part of the numerical expression to the variable. 
If the variable has not existed yet, its type will be integer. 


Qualifiers may be only used after a coordinate or transformation 
variable. | 


If the variable is of length type or the value is a length (for example, 
the x coordinate of a coordinate type variable), the numerical vaiue 
will be interpreted in the current length unit. 


The possible qualifiers after a coordinate type variable are {the 


defau!t is .L): 

X The x coordinate of the variables will get the new value, 
the y coordinate will remain unchanged. 

i The y coordinate of the variables will get the new value, 


the x coordinate will remain unchanged. 
‘Lor.R The distance from the origin will be assigned the new 
value, the direction will remain unchanged. 


A The direction wil! be assigned the new value (in 
degrees), the distance from the origin will remain 
unchanged. 
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VFLOAT 


Possible qualifiers after a transformation type variable (one of the 
qualifiers is obligatory): 


.11 of 

.12 oF 

.13: The selected element of the first row will be changed, the 
others remain unchanged. 


a 


.21 oF 

22 OF 

.23: The selected element of the second row will be changed, 
the others remain unchanged. 


.31 oF 

32 OF 

.33: — The selected element of the third row will be changed, the 
others remain unchanged. 
The first two elements in the third row must be zero, the 
third element must be one (0,0,1). 


.X or .DOX The x coordinate of the translation component of 
the transformation will get the new value. 

-Yor .DY The y coordinate of the translation component of 
the transformation will get the new value. 


SX The transformation's scale component in the x 
direction will get the new value. 

SY The transformation's scale component in the y 
direction will get the new value. 

A The rotation angle component will get the new 
value. 

var num 


var: variable name, 
num: numerical value or expression. 


Assigns the value of the numerical expression to the variable. 
tf the variable has not existed yet, its type will be floating point. 


Other features are the same as for the VINTEGER statement (see 
above). 
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VLENGTH 


VANCGLE 


var length 


var: variable name, 
num: numerical value or expression. 


Assigns a length to the variable. 


If the variable has not existed yet, it will be of length type. Other 
features are the same as for the VINTEGER statement (see above). 


var angle 


var: variable name, 
num: numerical value or expression. 


Assigns an angle value to the variable. 


If the variable has not existed yet, it will be of angle type. Other 
features are the same as for the VINTEGER statement {see above). 
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VCOORDINATE 


var coord 


var: variable name, 
num: numerical value or expression. 


The command assigns a coordinate value or a part of it to the 
variable. tf the variable has not existed yet, it will be of coordinate 
type. Qualifiers can be only used after a coordinate or 
transformation variable. 


Integer, floating point and length type variables are assigned the 
distance between the entered point and the origin as the new value. 


Angle type variables are assigned the direction of the entered point 
as the new value. 


Coordinate type variables without qualifier are assigned both 
coordinates of the point as the new value. Coordinate type 
variables with qualifier: 


x The x coordinate of the variable is assigned the x 
coordinate of the entered point. The y coordinate of 
the variable remains unchanged or, in the case of a 
previously non-existing variable, pets zero value. 


Y The y coordinate of the variable is assigned the y 
coordinate of the entered point. The x coordinate of 
the variable remains unchanged or, in the case 0’ a 
previously non-existing variable, gets zero value. 


tor .R The radius component of the variable is assigned 
the radius value of the entered point. The direction 
of the variable remains unchanged or, in the case of 
a new variable, the direction is set to zero, 


A The direction component of the variable is assigned 
the direction of the entered point. The radius of the 
variable remains unchanged or, in the case of a new 
variable, the radius is set to one. 


Transformation type variables without qualifier are assigned the 
vector from the origin to the entered point as the translation 
component of the transformation, the other components remain 
unchanged. Transformation type variables with a qualifier: 
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.117 or 
42 Of 
Pa ee 


21 oF 
.22 OF 
23: 


.31 or 
32 oF 
33: 


.X or .DX 
Yor .DY 


5X 


SY 
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The selected elenrent of the first row is assigned the 
radius value of the entered point. The other values 
remain unchanged. 


va 


The selected element of the second row is assigned the 
radius value of the entered point. The other values 
remain unchanged. 


The selected element of the third row is assigned the 
radius value of the entered point. The other values 
remain unchanged. 

The first two elements in the third row must be zero, 
the third element must be one. 


The translation component of the transformation 
will be the vector from the origin to the entered 
point, the other components remain unchanged. 


The x coordinate of the translation component of 
the transformation will be the x coordinate of the 
entered point. 


The y coordinate of the translation component of 
the transformation will be the y coordinate of the 
entered point. 


The scale factor in x direction is set equal to the x 
coordinate of the entered point. 


The scale factor in y direction is set equal to the y 
coordinate of the entered point. 


The rotation angle component of the transformation 
is assigned the direction of the entered point. 


comet? 


VXFORM var tran 


var. 
tran: 


variable name, 
transformation definition. 


The command assigns a transformation or a component of it to the 
variable, If the variable has not existed yet, it will be of 
transformation type. If the transformation contains a box (see 
BOX), the variable will also keep it. Qualifiers can be only used after 
a coordinate or transformation variable. 


integer, floating point and length type variables are assigned the 
length of the vector of the transformation's translation component 
as the new value. 


Angie type variables are assigned the angle of the transformation’s 
rotation component as the new value. 


Coordinate type variables without qualifier are assigned both 
coordinates of the transformation's translation component as their 
new value. Coordinate type variables with a qualifier: 


x 


.L or .R 


The x coordinate of the variable is assigned the x 
coordinate of the transformation's translation 
component. The y coordinate remains unchanged. 


The y coordinate of the variable is assigned the y 
coordinate of the transformation's translation 
component. The x coordinate remains unchanged. 


The radius component of the variable is assigned 
the length of the transformation's translation 
component. The direction of the variable remains 
unchanged. 


The direction component of the variable is assigned 
the angle of the transformation’s rotation 
component. The radius of the variable remains 
unchanged. 


Transformation type variabies without qualifier are assigned the 
entered transformation. Transformation type variables with a 


qualifier: 
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21 The elements of the transformation variable are given 
22 the values of the corresponding elements of the entered 
23 transformation's matrix. 


X or .DX The x coordinate of the translation component of 
the variable will be the corresponding value of the 
entered transformation. 


Yor.DY The y coordinate of the translation component of 
the variable will be the corresponding value of the 
entered transformation. 


SX The variable's scale factor in x direction is assigned 
the corresponding value of the entered 
transformation. 


SY The variable’s scale factor in y direction is assigned 
the corresponding vaiue of the entered 
transformation. 

A The angle of the transformation's rotation 


component is set equal to the corresponding value 
of the entered transformation. 


VTEXT var text 


var: variable name, 
text: text definition. 


Assigns the text to a textual variable and the length of the text as an 
integer value to another type of the variable. 


If the variable has not existed yet, its type will be textual. Other 
features are the same as for the VINTEGER statement (see above). 
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DIMARRAY 


DIALOG 


{ VINTEGER | VFLOAT | VLENGTH | VANGLE | VCOORDINATE | 
VXFORM | VTEXT } < var > ENTER 


var: array name, 
ENTER: completes array definition. 


Creates arrays of the given type or re-dimensions existing arrays. 
The maximal number of indexes is 8, the lower limit for each index 
is 1, the upper limits are the specified values. 


({ { vint  vfloat } var num] [vcoord var coord) [vangle var angle] 
(viength var length) [vtext var text] } 


The outer brackets "{" and "}" are real characters. 

Assigns values to variables. Opens a dialog box showing one or 
more variables and their defauit values which can be changed, 
Clicking OK, the values are assigned to the variables. The Cance! 
button cancels the command. 


E.g.: /dialog { vfloat num1 33, vangle dir 45, vtext namel ‘gear" }; 
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VINTEGER 
VFLOAT 
VANCLE 

VLENGTH 


Variable Definition by Dialog Commands 


topCAD provides special assignment commands to define variables 
and assign them values using a dialog box and files. These 
commands open a dialog box showing the values in the opened file. 
The choice among these values can be made in the dialog box. Two 
kinds of command can be used; the variable will be assigned 

e the chosen value, or 

e the sequence number of the value in the file. 


The commands handle only the first number in each line of the file, 
thus you can write comments following the data. 


The following commands assign the chosen numerical value to the 
variable: 


var ‘#Dfile' 
var '#Dfile' 
var '#Dfile' 
var '#Dfile' 


var: name of the variable, 
#Dfile: opens the "file", showing its contents in the dialog box. 


E.g.: 


e The contents of datafile] {in the Macro folder): 
123 
234 
345 
456 
567 
67890 
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Giving the command: /vint a5 '#Ddatafilet' 


a dialog box appears: 


detefilel 





The variable “a5" has been assigned the value "456". 
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VINTEGER 
VFLOAT 
VANGLE 

VLENGTH 


The following commands assign the sequence number of the 
chosen numerica! value to the variable. The sequence numbers 
start from 1. 


var '#dfile' 
var '#dfile' 
var '#dfile' 
var ‘#dfile’ 


var: name of the variable, 
#dfile. opens the "file", showing its contents in the dialog box. 


E.g.: Let us see the above example: 


e The contents of datafile (in the Macro folder): 
123 
234 
345 
456 
567 
67890 


© Giving the command: /vint a5 ‘#ddatafile1' 


the dialog box appears: 







daisfiie! 


* YS. BBR EUR aa ee KN BRB 
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Choosing a value, its sequence number will be assigned to 
variable "a5". 


Geisfile! 





The variable "a5" has been assigned the value "4". 
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The following commands show values given in the command itself 
instead of a file. 


The four commands below assign the chosen value to the variable: 


VINTEGER var ‘#Pheader < valint>' 
VELOAT var ‘#Pheader < valfloat >' 
VANGLE var ‘gPheader < angle >’ 

VLENGTH var ‘wPheader < length > 


var: name of the variable, 

#Pheader: the header of the dialog box, 
valint: integer type numerical value, 
yalfloat: _ floating point type numerical value, 
angle: angle value, 


length: length value. 
Eg: 
/VLENGTH 63 ‘@PScrew Length, 5, 6, 8, 10, 12, 16, 20' 


© The dialog box showing the values: 


Straw Length 














$crew Length 


5 | 

% 
: | 
Cancel | 






© the variable "b3" will be assigned the value "12". 
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The four commands below assign the sequence number of the 
chosen value to the variable. The sequence numbers start from 1. 


VINTEGER var '#pheader < valint>' 
VFLOAT _ var '#pheader < valfloat >’ 
VANGLE var '#pheader < angle >' 

VLENGTH var ‘#pheader < length >' 


var: name of the variable, 
#pheader: the header of the dialog box, 
valint: integer type numerical value, 

— valfioat: — floating point type numerical value, 
angle: angle value, 


length: length value. 
= E.g.: 
/VLENGTH b3 ‘#pScrew Length, 5, 6, 8, 10, 12, 16, 20' 


e The dialog box showing the values: 


Screw Leagih 
4% 





e the variable “b3" will be assigned the value "5". 
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VTEXT 


VTEXT 


VTEXT 


VTEXT 


VTEXT 


var '#S*' 
Shows the names of the defined symbols in the dialog box: 


var: name of the variable to be assigned a symbol name. 


The next commands show filenames in the dialog box: 
var '#F' 
Shows the Open dialog box for topCAD folder. 


var: name of the variable to be assigned a filename. 


var '#FM' 
Shows the Open dialog box for the Macro folder in topCAD folder. 


var: name of the variable to be assigned a macro name. 


var '#FD' 


Shows the Open dialog box for the Drawing folder in topCAD 
foider. 


var: name of the variable to be assigned a drawing name. 


var '#FS' 


Shows the Open dialog box for the Symbol folder in topCAD 
folder. 


var: name of the variable to be assigned a symbol filename. 
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VTEXT var '#FE' 


Shows the Open dialog box for the Environment folder in topCAD 
folder. 


var: name of the variable to be assigned an environment 
filename. 
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Assignation of Values to Variables 


A new value can be assigned to a defined variable by any definition 
command or an assignment command. E.g.: 


/viloat a3 (a2+.2°Cc) 
The value of the expression in brackets will be assigned to the 
variable named "a3". 
The variables "a2" and “c* must be defined up to this point. 


/vint a5 ‘#Ddatafile1' 
A value can be chosen in the dialog box from the file "datafilel". 
It will be assigned to the variable "a5". : 
(See the example at the beginning of this chapter.) 


aS = (c.x + 345°d8) 
The value of the expression on the right side will be assigned to 
the variable "a5". 


Notice that this is not a variable definition. The variables “a5", 
"c" and "d8" must be defined up to this point. 
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IF 


Control Statements 


The order of interpretation of the statements and other syntactic 
elements can be controlled by control statements. There are two 
main kinds of these statements: 


® conditional statements (IF and SWITCH) 
¢ loop control statements (FOR, WHILE, and DO) 


There are also some modification statements like ELSE after the IF 


Statement; and the BREAK and the CONTINUE statements enabling 
the loops to be left. 


num { statements? } [ ELSE { statements2 } ) 


num: expression (condition), 
statements1: series of commands to be executed if the condition 
“aum" ts true, 


statements2: series of commands to be executed if the condition 
"num" is false. 


(The { and ) brackets are real characters in this case!) 


if the numerical expression is true (#0), topCAD interprets the 
"statements1" only. 


If the numerical expression is false (=O), topCAD interprets the 
"statements2" only, if they exist. 


E.g.: 


IF (ln5) (COLOR 7 } 
If the value of the variable | is equal to 5, the statement sets the 
logical color to 7. 


COLOR iF (I>6) { 6 } ELSE { (1) } 
If the value of the variable | is greater than 6, the program sets the 
color #6, otherwise the color with the same number as the value of I. 


COLOR IF (I< J) { (1) LTYPE (J) } ELSE { (J) LWIDTH (1) } 

if variable | is smaller than variable J, the program sets the color to 
the value of | and the line type number to the value of J. Otherwise 
the program sets the color to the value of } and the line width to the 
value of |. 
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SWITCH 


num1 { < CASE num2 [num3] { statements1 } > 
[DEFAULT ({ statements2 } } } 


num: expression (condition) 
num2: case value(s) or lower limit of a range, 
num3: upper limit of a range, 


statements1: a series of commands to be executed if the value of 
num1 is equa! to one of the case values (num2) or 
fall in one of the ranges (num2 and num3), 

statements2: a series of commands to be executed if the 
numerical expression "num1" is not equal to any of 
the listed case values and does not fall in any of the 
listed ranges. 


(The { and ) brackets are real characters in this case!) 


If the numerical expression (num1) is equal to one of the case 
values (num2) or falls in one of the ranges (num2 and num3), 
topCAD interprets the corresponding “statements!" only. 


If the numerical expression is not equal to any of the listed case 
values and does not fall in any of the fisted ranges, topCAD 
interprets the “statements2" only, if they exist. 

Examples: 


SWITCH (1) 
{ 


CASE 1 { COLOR } 

CASE 2 { LTYPE } 

DEFAULT { LWIDTH } 
} 3 


if the value of the variable | is equal to 1, the statement sets the 

logical color to 3; if it is equal to 2, the statement sets the line 

type number to 3; otherwise it sets the line width to 3. 
SWITCH (2°1) { CASE 1 (J) {COLOR 2°F } } 


If the value of the variable 2°I is in the range 1, ..., J, the 
statement sets the color No. 2*1, otherwise there is no action. 
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PRINTF 
SWITCH (1) 
{ CASE 3 
{ "This is three" } 
CASE 5.7 
{ "This is between five and seven (%d)” (1) } 
DEFAULT 
{ "Other value" } } 
/ENTER 


The statement prints out the value of | if it is equal to 3 or in the 
range 5, ..., 7. In other cases it only writes out a notice. 
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FOR 


(var num1 [num2 [num3] ) } { statements } 


var: loop variable, 

num: starting value of the loop variable, 

num2: condition or limit for the loop variable, 

num3: step value (default value=1) 

statements: series of commands to be executed if the condition 


“num2" is true. 
(The { and } brackets are real characters in this case!) 
The command is the loop control statement in its general form. 


if the variable reference and the initial value (num1) are present, it 
effects a simple assignment (the type of the variable can be integer, 
floating point, length or angle). 


If the limit value (num2) is missing, the program executes the 
statements an infinite number of times (unless there is a BREAK 
among the statements). 


If the limit value is equal to zero, topCAD terminates the execution 
of the loop. 


After the execution of the statements topCAD adds to the loop 
control variable the step value (num3) if it is present; otherwise the 
variable is increased by one. 


E.g.: 
FOR 1,1,(l<=5) { COLOR (I) ... } 


The program executes the statements beginning with "COLOR (I)" 
five times. 


CIRCLE CPOINT 
FOR 1,10,(l<=90},10 { 100 100 (1) 100 } 


The program draws nine concentric circles around the point (100, 
100). 
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WHILE 


DO 


num { statements } 


num: expression (condition), 
statements: series of commands to be executed if the condition 
“num” is true. 


(The { and } brackets are rea! characters in this case!} 


If the numerical expression is true (#0), topCAD interprets the 
“statements” and then tests the numerical expression again. 


H the numerical expression is false (=0), topCAD ignores the 
statement. 
E.g.: 


VFLOAT X,0.5°A 

WHILE (ABS(X-A/X)>0.0001) 
{ VFLOAT X,0.5°(X+A/X) } 

PRINTF "Original=%f, built-ine%f, approx.=%f" 
(A) (SQR(A)) (X) ; 


The program computes the square root of a floating point value 


with an approximation. It also prints out the result found by the 
built-in function. 


{ statements } num 


statements: series of Commands, 
num: expression (condition). 


(The { and } brackets are real characters in this case!) 
topCAD interprets the “statements”, then calculates the value of the 
numerical expression. if the expression is true (#0), topCAD 


repeats the interpretation of the "statements". (This statement is 
very similar to the WHILE statement.) 
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BREAK 


CONTINUE 


EXIT 


ERROR 


tt eaves a FOR, WHILE or DO loop. No other statements in the 
loop will be interpreted and the loop will not be executed again. 


E.g.: 
FOR 1,1 (... VINTEGER 1,141 IF (I>10) { BREAK } ... } 
The loop will be left after the ninth repetition. 


Note that this is not the BREAK command from the topCAD tool 
palette. 


It leaves a FOR, WHILE or DO loop. No other statements in the 
loop will be interpreted but the loop will be executed again. 


E.g.: 


VINTEGER 1,1 
FOR { ... VINTEGER 1, 1+1 IF (I>10) { CONTINUE } 
IF (I>20) { BREAK } ... } 


The loop will be left after the nineteenth repetition but the second 
half of the kernel will not be executed after the ninth repetition. 


Quits the macro. 


{ ON | OFF } 


Sets/resets topCAD’s debugging function. It works together with 
the JOURNAL commana. If journaling is switched on, topCAD lists 
the executed commands into a file named topJournaln, where 
n=0,1,... (see the JOURNAL command). 


/ERROR ON results in listing of an error message, the filename and 
a maximum of 10 commands following the error in the current 
topjournal file. 


Chapter 3: Programing Tools 


E.g.: 


One of the commands in the below macro is syntactically wrong: 


/new /yes 

/carc p3 70 70 60 80 70 90;; 

/ecarce 3p 170 70 180 60 170 90;:;: 

/line /extremum 70 70 /extremum 171 71;; 
/line /extremum 70 90 /extremum 171 89;; 
/dimension /parallel 100 70 100 90 100 110;; 


Let’s find the incorrect Command. 


Turn on journaling: 
e Choose the Basic Settings command in the File menu, 
e click the journal file check box, 
(if it is checked: 
click the check box, 
click OK, 
choose the Basic Settings command again, 
click the Journal file check box) 
* type in “/error on". 


Run the macro and open the topjournaid file in the List folder. You 
will see the list: 
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# Version topCAD V1.20 1 June 1989 17:10 
# Written at 1 June 1989 22:26 

ferror 

fon 

fenter 

fnew 

fyes 
fcarc 

/p3 

(70) 

(70) 

(60) 

(80) 

(70) 

(90) 

fenter 

fenter 
feare 
51 Illegal expression 
HDO:Bi:topFolder:Macro:macro.error 
170 70 180 80 170 90;; 
/line /extremum 70 70 /extremum 171 71;; 
/line fextremum 70 90 /extremum 171 89;; 
/dimension /parallel 100 70 100 90 100 110;; 


oe ee he He He 


(170) 
(70) 
(180) 
(80) 
{170) 
(90) 
/enter 
/cancel 
/ journal 
/offt 


You can see that the correct commands are followed by the error 
message (starting with a “#" character), the name of the file where 
the error occurred and the commands foliowing the wrong 
command. 


The command 


/carce 3p 170 70 180 80 170 90;; 
has caused the error (the correct keyword is “/carc p3"). 
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CALL 


RETURN 


Parametric Macro/External Procedures 


The parts of a geometric construction that must be repeated 
(perhaps with slight differences) can be collected into a file called 
“parametric macro procedure". 


These procedures can be called anywhere, from the keyboard, 
from menu or from another procedure. The calling command 
contains the name of the file and the parameters. 

The procedure accepts the parameter line with the PARS command. 
A procedure can return a floating value to the caller, the RETURN 
command being used for this purpose. 

file [ {<< num | text >}} 

file. the filenarne of the macro, 

num: list of numerical parameters, 

text: —_ list of textual parameters. 

(The { and } brackets are rea! characters in this case!) 

topCAD suspends the execution of the current command line or 
parametric macro procedure, looks for the file, loads it and 
preserves the string of the parameters for the PARS command. 


If the file does not exist, topCAD ignores the call. 


num 

num: return value. 

The command returns from a parametric macro procedure. The 
floating point value will be passed to the caller which can reference 
it in any arithmetic expression (RET function). 

If topCAD reaches the end of a parametric macro procedure, it is 


interpreted as an implicit RETURN command with the parameter 
zero. 
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USERPROC 


PARS 


file 


Calls applications written in C, Pascal or FORTRAN programing 
languages. 


Parameters cannot be transferred to any external procedure in a 

parameter list (which can be done to a macro), The variables used 
by the external procedure must be assigned values before calling 
the externa! procedure. 


The applications should be in the Environment folder. See chapter 
Macro examples for details of using externa! procedures. 


< {VINTEGER | VFLOAT { VLENGTH | VANGLE ! VCOORDINATE | 
VXFORM | VTEXT) < var > ENTER > ENTER > 


The command receives the following parameter(s) from the caller: 
the integer, floating point, length and angle type variables require 
one numerical value each, the coordinate type variables require two 
{x and y), the transformation variables need 6 values for a variable 
and the text type variables need a text. 
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Exercise 1 


Macro Examples 


in the following exercises you can see some simple examples of the 
use of macros. All the below macros and external procedures can 
be found in the folder “Library” on the disk "topCAD/C". 


Let’s suppose you have to produce a gear with an NC machine 
tool. The tooth profile of the gear is represented by a spline in the 
drawing: 


(Displaying of the nodes of the splines and polylines is set by the 
Nodes command in the View menu:) 


(Uy 


0 
0 
0 
es 





The NC machine tool, however, cannot accept the spline which 
therefore must be approximated by lines or arcs and the nodes of 
the resulting object must be stored numerically. 


The spline can be convened into a polyline by the Spline Make 
Polyline command in the Modify menu: 
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As you can see, this is a poor anproximation, the number of the 
polyline nodes should be increased. 


This can be achieved, for example, by the following steps: 


e divide the spline into, say, 30 equal parts, 

« draw a polyline using the points dividing the spline as nodes of 
the polyline, 

e delete the spline, 

e redraw the drawing. 


The macro below realizes these steps: 


/dialog { vint Nodes 30 }; 
/vcoord P 'Click spline to convert’ 
/vf£loat rate 0 
/polyline 
/for i,0, (i<=Nodes) 
{ rate = (1*100/Nodes) 

cdivided (rate) (P.x) (P.y) 

bie 
/delete /select /sspline (P.x) (P.y)i: 
/redraw 


Let’s inspect the commands in this macro one by one: 
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{dialog { vint Nodes 30 }; 
Opens a dialog box showing the floating point type variable 
“Nodes" and sets its default value at 30: 





A new value for Nodes can be entered if necessary. Click the OK 
button to keep the value at 30. 


/veoord P ‘Click spline to convert' 
Defines a coordinate type variable named "P". The user defined 
prompt ‘Click spline to convert' prompts to select the spline that 
should be converted into a polyline. The coordinate values 
assigned to "P" are defined by the click. 


/vfloat rate 0 
Defines the floating point type variable "rate" to store the 
current proportion of the two parts of the divided spline. 


/polyline 
Draws a polyline after defining the nodes and giving an ENTER. 
The nodes will be defined in the following commands. (This is 
why no ENTER (;) follows the keyword "polyline". 


The next lines form a loop in order to divide the spline into 30 
equal pants and define the 31 dividing points: 


/for i,0, (i<=Nodes) 
{ rate = (i*100/Nodes) 
cdivided {rate) (P.x) (P.y) 
bei 
The loop starts with the Aor loop command defining the loop 


and contains a series of commands between brackets { } which 
are executed according to the condition in the for command. 
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/for i, 0, (i<=Nodes) 

Defines a loop. Contains a loop variable, its starting value and a 

condition. 

The operation of the command: 

the keyword “for" instructs topCAD to analyse the condition in 

the brackets. If the logical value of the condition is true, the 

command(s) between the brackets are executed. The loop 

variable is increased or decreased (in the current case it is 

increased by one) and the operation of the command starts 

again. If the logical value of the condition is false, topCAD skips 

the command(s) in brackets and executes the command 

following the loop. 

The elements of the command following the “for® keyword: 

i’ loop variable (integer); 

0: the starting value of the loop variable "i"; 

(i<#Nodes): condition: if the value of "i" is less than or equal 
to the value of the variable "Nodes", the 
commands standing after the “for? command 
between brackets are executed; 


{ rate = (i1*100/Nodes) 
The commands between the brackets will be executed in all 
cases when the "(iczNodes)”* condition is true. 
The vaiue of the proportion between the two parts of the spline 
divided by the current division point is assigned to the variable 
“rate ", 


ecdivided (rate) (P.x) (P.y) 
The /cdivided command creates a point dividing the selected 
object with the ratio (rate = (i*100/Nodes)) from the endpoint 
nearer the selection (point “P"). 
In our case the value of “i" starts from 0 and is increased by 
one until it reaches 30. The expression (i*100/Nodes) will take 
the following values: 
0*100/30 defines the starting point of the spline, 
1*100/30 defines the first dividing point at 1/30 of the spline 
2*100/30 cotta the second dividing point at 2/30 of the 

spline, ... 

(P.x) (P.y), the coordinates of the point "P", select the spline to 
be divided. 
The command, executed 31 times in the loop, defines 31 points 
on the spline dividing it into 30 parts of equal length. These 
points will be the nodes of the polyline approximating the 
spline. 
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} 7; 
The “)* terminates the series of commands in the loop, 
the first ";" (ENTER) completes the polyline, the second ";" 
(ENTER) completes the /polyline command. 


/delete /select /sspline (P.x) (P.y);; 
Deletes the spline nearby the point *P’. The "/select /sspline" 
command ensures that only the spline will be deleted (the 
polyline is also near the point “P” but it should not be deleted). 
The first “;* (ENTER) terminates the selection, the second ";" 
{ENTER} completes the /delete command. 


/redraw 
Redraws the drawing. 


Execute this macro: 


Clear the nodes by the Nodes command in the View menu: 


oO Oo aA O 


OWA 


(Y 


0 
O 
0 
0 





As you can see, the approximation is much better than simply 
fining a polyline to the nodes of the spline. 
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Exercise 2 inthe second example the curved part of the workpiece is: 


Conversion of this spline into a polyline with the Spline Make 
Polyline command in the Modify menu results: 


A much beiter approximation is needed again. The principle of the 
operation is similar to that in example 1, with slight differences: 


divide the spline into small equal parts, 

store the coordinates of the dividing points in two arrays, 
delete the spline, 

draw a smooth curve consisting of arcs, using the points that 
divide the spline. 


Note: Because of the approximation with a smooth curve of arcs, 
when the coordinates of all the points dividing the spline 
are calculated and stored it is necessary to delete the spline 
before drawing the smooth curve, Otherwise, if the spline 
exists when the curve of arcs is being drawn, the point "P" 
used to select the spline may select the curve of arcs, 
Causing confusion in the operation of the macro. 
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The macro which realizes this concept is: 


os /dialog { vint Nodes 30; } 
/vcoord P 'Click spline to convert' 
/vcoord divpoint 0 0 
/vfloat rate 0 
/dimarr vfloat Qx[(Nodes+1) Qy[Nodes+1}; 
/for i,0, (i<=Nodes) 
{ rate = {i1*100/Nodes) 
/vcoord divpoint /cdivided (rate) 
(P.x) (P.y) 
a Ox[i]) = (divpoint.x) 
Qy[i) = (divpoint.y) 
}); 
/delete (P.x) (P.y); 
— /ccurve smooth 
/for i,0, (i<*#Nodes) 
{ (Qxfi)) (Qy[il) }2; 


The functions of the commands are: 


/dialog { vint Nodes 30; 
Opens a dialog box with a etal number of the dividing 
points: 





Entering a value, you can change the precision of the 

a approximation; a number less then 30 results in a poorer 
approximation and vice versa. Let’s use this value; click the OK 
button. 


/veoord P ‘Click spline to convert' 
Defines a coordinate type variable named “P". The prompt 
‘Click spline to convert’ prompts to select the spline to be 
converted into a smooth curve. The coordinate values assigned 
to “P" are defined by the click. 


/vcoord divpoint 0 0 
Defines the coordinate type variable "divpoint" storing the 
coordinates of the current dividing point and assigns to it the 
ae Starting values 0,0. 
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/vfloat rate 0 
Defines the floating point type variable “rate” storing the current 
proportion of the two parts of the divided spline. 


/dimarr vfloat Qx(Nodes+1]} Qy[Nodes+1]; 
Defines two floating point type, one-dimension arrays named 
"Ox" for the x coordinates and "Qy” for the y coordinates of 
all dividing points. The size of the arrays is determined by the 
number of nodes (“Nodes") of the approximating curve, which 
has been defined by the /dialog command. 
Note that the size and the indexes of an array must be given 
between [ ] characters. 


The next commands form a loop to calculate the coordinates of 
the 31 dividing points and store them in the arrays “Qx" and 


Oy": 


/for i,0, (i<=Nodes) 
{ rate = (i*100/Nodes) 
/vcoord divpoint /cdivided (rate) 
(P.x) (P.y) 
Qx[{i]) = (divpoint.x) 
Qy[i}] = (divpoint.y) 
\? 


The ith elements of the floating point type arrays "Qx" and 


“Qy"will be assigned the coordinates of the iM dividing point 
calculated by the /cdivided command: 


(Note: this drawing does not appear when you execute the 
macro, it is an explanatory figure only.) 


The command uses the x and y coordinates ((P.x) (P.y)) of the 
point "P" to identify the spline to be divided. 
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The commands in the loop are: 


/for i,0, (i<=Nodes) 
Defines a ioop with the loop variable (i), its starting value (0) 
and the condition (i<=Nodes). 
The loop variable “i" will have the values 0,1,2, ..., 30. 


{ rate = (i1*100/Nodes) 
The current value of the expression on the right side wil! be 
assigned to the variable named "rate". This is the proportion of 
the two parts of the divided spline. The loop variable “i" will 
take the values 0,1,2, ..., 30. 


fvcoord divpoint /cdivided (rate) 
(P.x) {(P.y) 
Assigns the coordinates of the current division point of the 
object selected by the point “P" to the coordinate type variable 
“divpoint”. 


Qx(i) = (divpoint.x) 
Assigns the x coordinate of the current dividing point to the 
corresponding element of the floating point type array "Qx". 


Qy[i] = (divpoint.y) 
Assigns the y coordinate of the current dividing point to the 
corresponding element of the floating point type array "Qy". 


}; 
the “}" closes the loop, the ";" (ENTER) returns to the Commard 
prompt. 
fdelete (P.x) (P.y); 
Deletes the spline selected with the point “P". 
You don’t need it any more since its dividing points: 
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are stored in the arrays "Qx" and “Qy". This command also 

uses the point “P" to idertify the object to be deleted. 

(Note: this drawing does not appear when you execute the 
macro, it is an explanatory figure only.) 


/ccurve smooth 


Draws a smooth curve composed from arcs. It uses pairs of 
coordinates; the first three coordinate pairs define the first arc, 
each following coordinate pair defines the next arc. 

The coordinate pairs will be read from the arrays "Qx" and 
"Qy". 

Note that no ";" (ENTER) follows the command; consequently 
the following loop is embedded into it. 


/for i,0, (i<=Nodes) 


{ (Qx[i] }) (Qyli] ) |e: 

The coordinate pairs of the points dividing the spline are read 
from the arrays "Qx" and "Qy”. 

This loop reads the coordinate pairs from the arrays “Qx" and 
"Qy". Remember that these are the coordinates of the 31 points 
dividing the spline. Now these points will be the parameters of 
the /ccurve smooth command i.e. the curve will be fitted to the 
dividing points of the spline: 


\ 


The first ENTER (;) completes the curve, the second ENTER (;) 
quits the /ccurve smooth command. 
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Exercise 3 


in the third example the curved part of the workpiece looks like 
this: 


in order to make a good approximation, 


divide the spline into smal! equal parts, 

store the coordinates of the points dividing the spline in a file, 
* draw a polyline using the division points of the spline as nodes 
for the polyline, 

delete the spline, 

redraw the drawing. 


These operations can be performed with the following macro: 


/dialog { vint Nodes 30; } 
fvcoord P ‘Click spline to convert' 
f/openprint “::List:Spline Points" 
/printt ":;List:Spline Points" "/polyline "; 
/vfioat rate 0 
/for i,0, (i<=Nodes) 
{ rate = (i*100/Nodes) 
fvcoord Q /cdivide {rate) (P.x} (P.y) 
f/printf “::List:Spline Points” 
"$10.4f $10.4f" (0.x) (Q.y): 
; , 
/printf Ws Lest *Spline: Pointe "se" 
/closefile “::List:Spline Points"; 
/delete /select /sspline (P.x) (P.y); 
/call “::List:Spline Points" 
/cancel 
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The functions of the commands are: 


/dialog { vint Nodes 30; } 
Opens a dialog box with a default number of the dividing 
points: 





Entering a greater value, you can improve the precision of the 
approximation; let’s enter now the value 40, then click the OK 
button. 





/vcoord P ‘Click spline to convert' 
Defines a coordinate type variable named "P". The user defined 
prompt ‘Click spline to convert’ prompts to select the spline to 
be converted into a polyline. The x,y values assigned to "P" are 
defined by the click. 


/openprint “::List:Spline Points” 
Creates a file with the name "Spline Points" in-the List folder and 
opens it for output. The coordinates of the points dividing the 
spline will be stored in this file. 


/printt "::List:Spline Points" "/polyline "; 
Loads the keyword "/polyline" into the beginning of the file 
“Spline Points”. 


Later we will collect the coordinates of the points dividing the 
spline in this file; they will be used as the parameters of the 
/Polyline command. This file will be used as a macro when 
drawing the polyline approximating the spline. 


/vfloat rate 0 
Defines the floating point type variable "rate" which will store 
the proportion of the two parts of the spline divided by the 
current dividing point. 
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The following lines form a loop which defines the dividing 
points and puts their coordinates into the file "Spline Points”: 


/for i,0, (i<=Nodes) 
{ rate = (i1*100/Nodes} 
/veoord Q /cedivide (rate) (P.x) (P.y) 
/printf “::List:Spline Points” 
"$10.4f $10.4f" (Q.x) (Q.y); 
} 


/for i,0, (i<=Nodes) 
Defines a loop with the loop variable (i), its starting value (0) 
and the condition (i<=Nodes). 
The loop variable "i" will take the values 0,1,2, ..., 40. 


{ rate = (i*100/Nodes) 
The current value of the expression on the right side will be 
assigned to the variable named “rate”. This is the proportion of 
the two parts of the divided spline. The loop variable "i" will 
take the values 0,1,2, ..., 40. 


/veoord Q /cdivide (rate) (P.x) (P.y) 
Defines the ith point dividing the spline and assigns its 
coordinates to the coordinate type variable "Q". (P.x) and (P.y) 
are the x and y coordinates of the point "P" which identifies the 
object to be divided. 


f/printf "::List:Spline Points" 
"$10.4f %10.4£" (Q.%) (Q.y): 
Stores the coordinates of the point "Q” in the file called "Spline 
Points". The command, according to the syntax rules of the 
programming language "C", consists of a parameter lis. (%of: a 
floating point number) and a list with the same number of 
variables. 
%10.4f: represents a 10-digit floating point number with 4 
decimal digits. 


} Closes the loop. 
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/printf “::List:Spline Points” "77"; 
Stores two ENTERS at the end of the file "Spline Points". One 
ENTER will complete the polyline approximating the spline, the 
other ENTER quits the /Polyline command. 


/closefile "::List:Spline Points"; 
Closes the file “Spline Points". This file, containing the keyword 
/Polyline followed by 41 pairs of coordinates and two ENTERs 
(;;), is a complete polyline definition command which can be 
used as a macro (see below). 


/delete /select /sspline (P.x) (P.y): 
Deletes the spline identified by the point "P". The /select /sspline 
keywords are necessary if there are also other objects near the 
point "pl 


/call “::List:Spline Points" 
The file "Spline Points" is called as a macro to draw the polyline 
approximating the spline, using the spline dividing points stored 
in the file as nodes: 


As it is shown here, you can call macros from any macro 
without any limitation. 


/cancel 
Returns to the Command prompt. 
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The contents of the file “Spline Points" is a syntactically correct 
polyline definition command: 


/polyline 


me 


me 


40.0000 
40.3935 
40.9313 
41.5948 
42.3887 
43.3272 
44.4283 
45.7233 
47.2560 
49,0556 
51.1463 
33.8562 
56.3132 
59.4979 
63.1693 
67.3612 
72.0751 
td ehoeo 
B2,86544 
68.8094 
§5,0000 
102.129¢5 
167.1456 
132.7466 
117.9249 
122.6386 
126.636? 
130.5022 
133.6868 
136.4419 
436.8517 
140.9444 
1$62.7440 
144.276? 
145.5717 
146.6726 
347.6084 
34B.4C53 
449.0702 
149.6967 
150.9000 


200.0000 
193.7700 
187.5453 
161.3402 
S oedoge 
168.9752 
162.8294 
156.7218 
150.6697? 
144.6916 
138.8096 
133.0509 
127.4493 
122.0830 
117.0342 
112.4127 
108.3234 
104.6426 
162.0957 
100.2429 

99,5367 
100.2425 
102.0958 
104.8427 
168.3234 
112.4317 
127,0342 
122.9812 
127.4493 
133.0509 
138.8098 
144.6916 
150,669? 
156.7218 
162.8294 
168.9738 
tS .13t6 
161.3412 
287.5595 
19337225 
200.0900 
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Exercise 4 


In mechanical engineering you must often draw nuts. Let’s see how 
a tool for drawing any standard nut can be created in topCAD. A 
solution to this problem is to write some macros. 


The functions of this nut drawing macro set: 


* show the possible sizes according to the industrial standards, 
which enables you to choose the required one, 
create as a symbol the nut of the chosen size, 
locate the symbol. 


In order to draw a nut using this set of macros, just the following 
steps are required: 


« definition of the size of the nut, 
* definition of the scaling, 
e locating the nut. 


The structure of a macro system for the above task is: 











Dataset 
*Diameters" 






Macro ? 
"Standard Nut" 






Dataset 
“Data” 










? 


Size definition 





Dataset 
“Scaling” 










Macro 
"Draw Nut" 







Drawing 
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The file structure is: 


Lidre 
43K tm disk 


EI 


T37K avafiadle 


oF 


Seahng Diameters 
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The macro "Standard Nut": 


FRA AREA EERE RARER RRR ERE RARER ARERR RE RR EE HE 


‘ * 
# Standard Nut # 
# # 


GR RE RR REAR RE REE RE REE HE 


# 

# variable definitions for the dimensions of the 
# nut 

{/vfloat da 0 
/vfloat dwa 9 
/vfloat ea 0 
{vfloat pa 0 
/vfloat mag 0 
{/vfloat mila 90 
/vfloat sa 0 
/vfloat ga 0 
/vinteger i 0 


# 

# open a dialog box to choose a diameter 

# 

/vinteger ind ‘#d:Standard Nut Folder:Diameters' 


/yvtext file “:Standard Nut Folder:Data" 


# 
# define the first part of symbol name 
s 
/yvtext alap “Standard Nut M" 
/vinteger eo (EOF (file)) 
/if (eo>=0) 
{ /closefile /use file ) 


# 
# open the data file 
# 
f/openscan /use file 
/vinteger eo (EOF (file) ) 
/if (eo0<0) 

{ fexit } 


Chapter 4: Macro/External Procedure Examples 


+ 
# read the nut data from smallest until selected 
a 
/for iO (i<ind) 
{ /scanf /use file “%f" da "&f" pa "tf" dwa 
"$f" ea "$F" mag “%f" mia 


"RE" sa "Ef" ga "tl" spec: } 


/vinteger eo (EOF (file}) 
/if {eo>0) 

{ fexit } 
/closefile /use file 


# 

# create a symbol name for the nut 

# 

/vtext snev /concat /use alap /use spec; 


# 

¥# call the drawing macro 

# 

foall ":Standard Nut Folder:Draw Nut" 
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The macro "Draw Nut": 


FRA AAR AAR EEE REAR ER EERE EKA RRA ERE REE EE OH 


# # 
# Draw Nut # 
# # 
PARRA RAR EERE RRA ERE ERR EERE REE ERE ARR 
& 

# define the nut as a symbol 

# 


/symbdef /use snev 
/vint e (err) 
/vfloat mm 0 
/eancel 
/if (0=e) 
{ 
/autosave off 
/attributes put all 9 
/layer /active /only 255; 


# 
# calculate the dimensions of the nut 
# 
/vcoord oa -1000 -1000 
/vlength ¢ (sa/0.866) 
/vlength w (oa.x-mag+c/20) 
/vliength v (oa.x-mag) 
/vlength u (oa.x~-¢c/20) 
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a 
# draw nut 
# 


/line /single 
(w) {oa.y-c/2) (u) (oa.y-c/2) 
(w) (oa.y-c/4@) (vu) {(oa.y-c/4) 
(w) (oa.y+e/4) (u) foa.y+c/4) 
(w) (oa.ytc/2) (u) (oa.y+c/2) 
(oa.x) (oa.y-c*.375) (oa.x) (oa.y+c*.375) 
(v) (oa.y-o*.375) (v) (oa.yte*.375); 


/feare /p3 
(w) (oa.y-c/2) (v) (oa.y-co*.375) (w) foa.y-c/4) 
/recall {(v) (oa.y) (w) (oa.yte/4) 
/recall (v) (oa.ytce*.375) (w) {(oa.yte/2) 
(u) (oa.y-c/2) (oa.x) (oa.y-c*.375) (u) (oa.y-c/4) 
/recall {(oa.x) (oa.y) (u) (oa.y+e/4) 
/recall (oa.x) (oa.y+eo*.375) (u) (oa.yte/2); 


fautosave on ° 


7 

# define symbol 

# 

/symbdef /use snev 

/slayer /active; 
(oa.x) (Oa.y)?; 


# 
# delete nut 
# 
/delete (o0a.x)} (oa.y); 
f/layer /active 1; 
flayer /off 255; 
/attributes /get /all 9 
} 

/cancel 


/autosave /off 
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# set scale 


# 


/global /vfloat ma 


/if (ma=0) 


{ 


{ma} 


/vinteger mam '#d:Standard Nut Folder:Scaling' 


/switch 


{ 


/case 
/case 
/case 
/case 
/case 
/case 
/case 
/case 
/case 
/case 
/case 


{mam) 


wna nti bh Ww YH 


10 
ad 


/default 


} 


mn = {1,0/ma) 
{1.0/mm) 


/dscale 


Chapter 4: Macro/External Procedure Examples 


ma * 100) 

ma = 50} 

ma = 10} 

ma = 5} 

ma = 2} 

ma * 1} = 
ma = 0.5} 

ma = 0.2) 

ma = 0.1} 

ma = 0.02} 

ma = 0.01} 

vfloat ma ‘Scale'}} 


# 
# position symbol snapped to the nearest 
# intersection of the selected object 
# and aligned to it 
# 
/position /symbol 
fuse snev 
/while (1) { 
/vcoord col /origo 
fvangle al /aparallel 
"Position the nut or click Cancel' 
/veoord col /recall 
/if (col.x=0) { /break } 
fvecoord co2 /minters /recall 
/vlength dx (co2.x-col.x) 
/vlength dy (co2.y-col.y) 
/vangle da (0) 
/if (dx=0) { dx = (0.01) } 
/if (dx<0) { da = (180) } 
/vangle a2 (atn(dy/dx)+da) 
/if (abs(a2-al)>1) { al = (a1+180) } 
faxform /muititrans /xscale (mm) /origo 
/rotation (a1) /origo; 
(co2.x) (co2.y) 
}23 
/autosave /on 
fcancel 


Exercise 4 


223 


The dataset "Diameters": 


M5 

Mé 

M8 
M1C 
M12 . 
M>6 
Mee 
(M22) 
M24 
(M27) 
M30 
{M33} 
M36 
M39 
M42 
(M&S) 
M48 
(soe! 
MS6 
(MEL) 
M64 
M726 
MScx6 
MSOOx6 


7. A cal 
MII OXS 
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The dataset "Data": 


5 0.86 6.7 8.63 4 2.7 8 1.11 5 
6 1 8.7 10.89 5 3.5 10 2.32 6&6 

B 2.25 11.5 14.2 6.5 4.6 13 4.62 8 

1¢ 1.5 i8.5 18.72 8 5.8 17 10.9 20 

12 1.78 17.2 20.88 10 7.4 19 15.9 12 
1€ 2 22 26.17 13 9.7 24 30.6 16 

20 2.58 27.7 32.95 16 12.1 36 66.3 25 
22 2.5 29.5 35.03 18 13.7 32 80.2 22 
24 3 33.2 39.55 19 14.4 36 103 24 

27 3 38 45.2 22 16.8 41 154 27 

30 3.5 42.7 50.85 26 18.4 46 2:6 3¢ 
33.3.5 46.5 55.37 26 20 50 27: 33 

36 4 51.1 66.79 29 22.4 55 369 36 

329 4 55.9 66.44 31 23.8 60 472 39 

42 4.5 59.9 71.3 34 26.2 65 61¢ 42 

45 4.5 64.7 76.95 36 27.8 70 750 45 
48 5 69.4 82.6 38 29.4 75 924 48 

$2 5 74,2 68.28 42 32.6 8C 223C 52 

56¢ §.5 78.7 $3.56 45 35 BS 1356 56 

66 € 63.46 99.25 48 37.4 90 1690 62 

64 6 88.2 104.66 5: 39.6 95 1886 64° 
72 6 97.7 3236.16 56 45.2 2:05 2820 72 
60 6 167.2 127.4€ 64 50 115 3262 BE 
90 6 122.1 144.08 72 §€.4 1359 4680 92 
100 6 135.4 162.02 BS 62.8 145 6432 :c2 


The dataset "Scaling": 


an . > 
Ln ee 
2 t9 © 
La) 


4 bf pa gsr ge 
° a 


= b+ b-' 4 AD Ot ge 


"> 2 oo . 


BRR SEE Kz iz 
+ tm + CM HS 4 

a9 $4 g4 

ad 


Oo -- 


t? o> 
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Exercise 5 


External Procedures 


The following examples are mainly for those who are familiar with 
programming. 


In topCAD you can use, apart from topCAD macros, external = 
procedures written in the popular high-level programming languages 

MPW C 3.0, MPW Pascal 3.0, Language Systems FORTRAN V1.2.1 

under MPW 3.0. This facility may help you to make fast-running 

procedures realizing complex functions such as iterations, etc. Let’s = 
see a simple (Exercise 5) and a little bit more complex (Exercise 6) 

example. 


The task is to draw the well-known Lissajous Curve: 


We have a C program, a Pasca} program, a FORTRAN program 
and atopCAD macro, all performing the same task. You can 
compare the solutions (particularly the running times!). 
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The source programs: 
*e Lissajous.c 
* Lissajous.p 
® Lissajous.f 


the command files: 

e C&Link 

e Pascal&Link 

¢ FORTRAN&Link (see below) 


the compiled and linked stand alone applications: 

¢ = LissajousC 

e LissajousP 

e = LissajousF 
which can be called by the /userproc command from a topCAD 
macro 


and the macros: 
e § Lissajous 
¢ LissajousM 


are in the "User Procs” folder on the disk "Library". 
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Starting the macro "Lissajous", you define the parameters of the 
curve and choose which routine should be executed: 


BER RR RRR TRE IRR ER EERE EE EERE ER ENS 


+ # 
# Lissajous - topCAD macro choosing a routine + 
+ # 


RR REE RR RAR RETA R ERR ER EMRE EE RH 
/vint a '#PHorizontal ip er ac prs ee os loin an Gr grea Pa a A 
/vint b '#PVertical ?,1,2,3,5,7,11,13,17,19,23,31' 
/vint i ‘#pLanguage?,C, Pascal, FORTRAN, Macro’ 
fswitch (i) 

{ 


/ease 1 { /userproc LissajousC } 
/ease 2 { /userproc LissajousP } 
/ease 3 { /userproc LissajousF } 
/fcease 4 { /call LissajousM } 


}i 
/List “Number of new objects: td" (i); 


Choosing 

e i 

a “Pascal" 

e "FORTRAN" or 
e "Macro", 


one of the following programs or the macro wiil be executed: 
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LEAR ARERR ARE RAR RRR RR RR ER eit / 


/* sd 
/* Lissajous.c - C routine to draw curve */ 
/* a 4 
LRA ERR HERR RERR ARERR EE ARREATERER AER K ERR ERE REE RE / 
# include <types.h> 

# include <math.h> 

# include <SANE.h> 

# include <stdlib.h> 

# include ";:topiInterface:topProc.h" 


void Lissajous {} 


{ 


ant 


extended 


a 0 
Se Mle Vly Kee Vee Re Va oR; By 


a= GetVariable {"A"); 

b = GetVariable ("B"); 

SetVariable (“topColor", 3); 

n= 20*atb; 

x = a/pi{); 

y = b/pi(); 

for (xl = 100.0, yl = 150.0, i=l: i <= nn; its) 


{ 


ee 1.7 -10.0% 
x2 = 100 + 50 * sin (t/x); 
y2 = 100 + 50 * cos (t/y): 
SetLine (NewOb3(), xl, yl, x2, y2); 
x1 = x2; yl = y2; 
} 
SetVariable ("I", i-1); 
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(SPEAKER AR ERE MEKKER EAE R RRA eee Ree eee eee eee ) 
(* *) = 
(* Lissajous.p - Pascal routine to draw curve *} 
x x 
pipedizitaveaiacseaccevaceesdateesastesea 
UNIT myUnit; 
INTERFACE 
USES 
{$U MemTypes.p} MemTypes, a 
{$U QuickDraw.p} QuickDraw, 
{SU OSInt£.p} OSIntf, 
{$U ToolIntf.p} Toolintf, 
{SU PackIntf£.p} Packintf, - 
{SU ::topInterface:topProc.p} User; 
FROCEDURE Lissajous; 
IMPLEMENTATION 
PROCEDURE Lissajous; 
VAR on, i, m: INTEGER; = 
t, xl, yl, x2, y2, a, b: EXTENDED; 
BEGIN 
a := GetVariable (‘A'}; 
b := GetVariable ('B'); 
SetVariable (‘'topColor', 4.0); ° 
xl :# 160.0 ; yl := 150.0; 
m :™ round(20*a*b); 
FOR i := 1 TO m DO BEGIN 
t 32 2-7: 10.05 - 
x2 :™ 100 + 50 * SIN (t/a*PI); 
y2 := 100 + S0 * COS (t/bD*PI); 
n := NewOb}; 
SetLine (n, xl, yl, x2, y2); 
Hl 2@ x2 5 yl s= v2; 
END; 
SetVariable ('I’, i-1.0); 
END; 
END. 
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CHAAR AREA EE HRENRAAEREREEREAAEERA HEC REERERREN REE) 


Cc* 
C* Lissajous.f - FORTRAN routine to draw curve 
c* 


= 


*) 


74 


CARRERE REE RERE RA EKER AREA KEEN AEE EERE ER ERK RE DH ) 


20 


subroutine Lissajous 


INCLUDE ‘:;:topInterface:topProc.f' 
integer*4 i,m, n 

extended t, xl, yl, x2, y2, a, b 
CHARACTER*1 NULL 

string aa, bb, ii, color 


NULL = 0 
aa = "A'//NULL 
bb = "B'//NULL 
ie = 'T'//NULL 
colors ‘topColor'//NULL 
CALL FGetVariable {tref{aa), tref(a)) 
CALL FGetVariable (%tref{(bb), %tref(b)) 
CALL SetVariable (%ref(color), 5.0) 
x1 = 100.0 
yl = 150.9 
me 20*a*b 
do 20 i=l,m 
t = £2 7 10,4 
x2 = 100.0 + 50.0 * SIN(t/a*PI) 
y2 = 100.0 + 50.0 * COS(t/b*PI) 
CALL FNewObj (%ref (n)) 
CALL SetLine (n, xl, yl, x2, y2) 
x1 = x2 
yl = y2 
continue 
CALL SetVariable (%ref(ii), i-1.0) 
return 
end 
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The C, Pascal and FORTRAN programs above use the following 
topCAD interface routines: 


e GerVariable: accepts a topCAD variable 

e SetVariable: assigns value to a topCAD variable 

e NewQOb): defines a new topCAD object ae 
* SetLine: defines a tine type object by its endpoints. 


The list of topCAD interface routines can be found in the C header 
file named topProc.h, the routines are in the folder “topinterface" zs 
delivered on the disk topCAD/C. 


Note: In FORTRAN we use subroutines instead of functions. E.g.: 


instead of the above NewQbj function the FNewObj subroutine is 
used. 


FRA ARR EERE RAE RE KER KER EERE 


# 4 
# LissajousM - topCAD macro to draw curve ¥ 
# + 


FREER AARNE ARERR EERE ETE EERE RHA RR ERE EERE eae 


/vfloat x (a/180) 
/vfloat y (b/180) 
fvint 1°6 
/vint n 20*a*b 7 
fundo off 
/line 100 150 
feolor 2 
/for i,il, (i<=n) 
{ (50*sin(O0.1*i/x}+100) (S0*cos(0.1*i/y)} +1900) } 
/vint i (i-1) 
fundo on 
/cancel 


In order to compile and link a program, run one of the following 
procedures: 
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FEARAKAKKRARERKAERNAEAKRAERAREEKEEEKERAEKEKEEKAAAAERAEREAREARER HRY 


# # 
# C&Link - command file to compile and link the # 
¥ C routine “Lissajous.c" # 
4 4 


PERAK KEARAAEAHE EKER ERAEEAKEAEEAESEKATERAKAEKKHEAREAREKREKA RRR A REE HE 


Directory "::User Proc" 


C -r -b -mce68020 -mc68861 -o Lissa jous.c.o Lissajous.c 
Link <0 ::Environment:LissajousC d 
=-¢ "epee 3 
-t ‘data’ d 
-d d 
-sg Lissajous d 
=m Lissajous re 
“rt USER#=0 0 
Lissajous.c.o a 
::topInterface:topLib.o é 
"{CLibraries}"CLib8Bl.o a 


"{Clibraries}"CSANELib&881.0 
Delete -y Lissajous.c.o 


ERK AAREAKRERKEAETAKAAKRAREKEAARAATEAEAAAKAARRAKEKKAARETERA AKER KE AEE 


# # 
# PascaléLink - command file to compile and link the # 
# Pascal routine “Lissajous.p" # 
# # 


RECA EERE ERA REKTEREREKAREKARAARERE EEK EE KM AKRAM RERARA EA KE eg 


Directory "::User Proc" 
Pascal -mc68020 -mc68881 -o Lissajous.p.o Lissajous.p 


Link -oO ::Environment:LissajousP 
=¢ ae a a 
== ‘data’ 
a 


-sg Lissajous 

—™ LISSAJOUS 

-rt USER=0 

Lissajous.p.o 

>:topinterface:topLib.o 

"“{Libraries}"“Interface.o 

“{PLibraries]"PasLib.o 
Delete -y Lissajous.p.o 


Maa a Qa Qs dy a 
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ERR REAR ERE RAR RARE ERE RETREAT ERK ERE EERE CREE EEK HE 


# + 
# FORTRANGLink - command file to compile and link the + 
+ FORTRAN routine “Lissajous.f” & 
# + 


FR ER RRA TEER EEE ERATE EMR A RE REEEEAHER EE 


Directory "::User Proc” 
FORTRAN -mc68020 -mc68881 -extended -case Lissajous.f 


“rt USER=0 

Lissajous.f.0 

*{Libraries}"Interface.o 

“{FLibraries}“FORTRANLib.o 

;:topInterface:topLib.o 
Delete -y Lissajous.f.o 


Link -o ::Environment:LissajousF d 
eaeeetrrrey 3 

-t ‘data’ 3 

<a a 

-sg Lissajous 7) 

-m Lissajous d 

a 

0 

d 

d 
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Exercise 6 


The last task again is the approximation of a spline with arcs. We 
will do it calling the external procedure "SplineToArc” written in "C" 
(see below) which results the fastest and most qualified solution. 


All the below files are in the "User Procs" folder on the disk 
"topCAD/C", 


The calling macro "Call SplineToArc": 


PTAA AKEEHEKRERKEEAREAKERERAER EEE REHEAT ER RE KE 


+ 4 
# Call SplineToArcC - macro executing SplineToArc # 
# 4 


FRE KERAARE MEEKER ERRERRTREEA KREME ARH RRR E 


AAT RARAEAERAKEEEEREEERRAER EAR ERERERARRK KKK KH 


/vint nSpline 0 

/vint nArecs 0 

/dialog { vfloat EPS 0.1 } 

fundo off 

fuserproc SplineToArcC 

/list “Converted # td spline to # %d arc" 
(nSpline) (nAres); 


fundo on 
REA CETERA MERAAEAAKREMHEKERAAARERMCRERARAARARKN KK 


It defines some variables: 


nSpline: the number of splines, 

NAICS: the number of arcs, 

EPS: the tolerance: the difference between the spline and the 
arcs will be less then or equal to this value (this is the 
precision of the approximation), 


calls the external procedure "SplineTo ArcC", 
lists the number of converted splines and the number of arcs in the 
Curves. 


The SplineToArc.c procedure: 
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ES hokok Kaho ok hehshohcichahehehehelelehahehelehaleieheleleleheheheheheheheheiehetebeheheheheneneheieieneieieieneieieleieielel | 


/* */ 
/* SplineToArec.c DEMO PROGRAM to topCAUSERPROC xf 
/* a 
/* SMOOTHING SPLINES WITH ARCS a/ 
/* * 
j/* x / 
/* Saturday, 27 May 1989 0:32:08 a7 
/* Written by Szabé Lérdnt Graphisoft ot é 
a iid 


[RIOR TR TOR TOIT IR ERR EERE RRR RE RES RRA RK ERS / 


JIGS ISO OIISIOUIICISIISIISIIUIOIUIIIOIIOIUIDICIOIUINOCIDIDIOR TOO IODII IORI ARSE K / 


{* x / 
{® INCLUDE HEADER FILES a / 
/* xf 


JOO IOIOIOOIOUIIDIUIDIDIOIIOIIOIIIOIOOIUIIISIOIIDIOIOIUIIIUIOCI IOI IIR EASE E / 


include <types.h> 

include <math.h> 

include <SANE.h> 

include ":;:topInterface:topProc.h” 


* We Mk Me 
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LEAR ERATE EE REAR HEE RARER ARERR ERA AERE ERNE ARE RARE ERE EE / 


/* 
/* 
/* 


ai 
w/ 
ay 


DEFINITIONS 


LRA REE AEA EERAERA EERE ERE EEA REAR RAERARAARE RARE ERE RAK KR / 


#define 
#define 
#define 
#define 
void 


LA 


COORD 


int 


sit 


EpsDeg 
TotDeg 
RadToDbeg 
PREC 
SplineToArc 
Convert 


Horner 


CreateArc 


TestDistance 


0.15 
360.0 


(180.0/pi()) 


20 


(); 
{int Id); 


{extended 
COHandle 
COxHandle 
COHandile 
COHandle 


(COORD 
COORD 
COORD 
COORD 
extended 
extended 
extended 


(COHandle 
COHandle 
COvHandie 
COHandle 
extended 
extended 
COORD 
extended 
extended 
extended 
extended 


t, 
a; 
b, 
Cr 
a); 


leftPoint, 

middlePoint, 

rightPoint, 
*Origo, 
*Radius, 
*Alpha, 
*Delta); 


Coeff0, 
Coeffl, 
Coeff2, 
Coeff3, 
tBeg, 
tEnd, 
Origo, 
Radius, 
Alpha, 
Delta, 
epsilon); 
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[RRR REE RE RE EE REE RR ERE EERE REE RR RRR EMR HK / 


/* 7 
{*. MAIN ENTRY POINT w/ 
/* a 


LRERREAARAARAAA ASSES AAAS AS © CHECKER EEA REAR EEE AR EK / 


void SplineToArc ()} 


{ int nSpline, nArcs, next; 


SetVariable ("topColor", 1); /* Set black color */ 
SetVariable ("topLTYPE”, 1); /* Set normal line type */ 
SetVariable ("topLWIDTH", 0); /* Set narrowest line width */ 


for (next = iFirst, nSpline = nArcs = 0; ; )} 
{ 
next = NextCbj (next); /* Look for the next object */ 
if (next s= iEnd) break; /* If last then break s/ 
if (ObjType (next) == kSpline) 
nArcs += Convert (next), nSpline++; 


} /* If spline call convert at 
SetVariable ("“nArcs", mnArcs}); /* Number of created arcs e/ 
SetVariable ("nSpline", nSpline);/* Number of splines lt | 


Chapter 4: Macro/External Procedure Examples 


LAER REAR AREA AERA AREAARARERKERTAATAREAERE ENE KER RE / 


/* 
/* 
/* 


CONVERT A SPLINE TO ARCS 


= 
of 
aij 


LRREREEAHR REET REE A AREER EEE EERE RARER EAE ARR KER EERE ER RH / 


int Convert (id) 


id; 
COORD origo, Origo; /* Previous and current 
extended radius, Radius; /* Previous and current 
extended alpha, Alpha; /* Previous and current 
extended delta, Delta; /* Previous and current 


COHandle Coeff0, Coeffl, Coeff2, Coeff3; 


origo */ 
radius*/ 
angle */ 
range */ 


/* Spline coefficients */ 


COORD leftPoint; /* Left point of arc e7 
COORD middlePoint; /* Middle point a g 
COORD rightPoint; /* Right point of are af 
int Nodes; /* Number of nodes on spline */ 
extended resol; /* Spline resolution le 
extended col; /* Color wf 
extended Tl, T2, t2; /* Work variables for loop */ 
int nArcs; /* Number of created ares wf 
int first, ret; /* Codes */ 
extended Eps; /* Precision a 
nArcs = 0; 

col = GetVariable ("topColor"); 

SetVariable ("topColor", ++col); 

Eps = GetVariable ("EPS"); 

Eps = fabs (Eps); 

if (Eps > 0.5) Eps = 0.5; 

if (Eps < 0.0001) Eps = 0.0001; 

Coeff0 = (COKandle) NewHandle (0); 

Coeffl = (COHandle) NewHandle (0); 

Coeff2 = (COHandle) NewHandle (0); 

Coeff3 = (COHandle) NewHandle (0); 

GetPSpline (id, &resol, &Nodes, Coeff0, Coeffl, Coeff2, Coeff3); 


leftPoint = **Coeff0; 
first = true; 
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for (Tl = 0.0, T2 = Eps: T2 < Nodes = 1 + Eps/2.0; T2 += Eps) 
{ 
if (T2 > Nodes - 1) T2 = Nodes - 1; 
middlePoint = Horner {Ti + {T2 - T1)/2.9, 

Coeff3, Coeff2, Coeff1l, Coeff0); 
rightPoint = Horner (T2,Coeff3, Coeff2, Coeffl, Coeff); 
ret = CreateArc (leftPoint, middlePoint, rightPoint, 

&Origo, &Radius, é&Alpha, é&Delta}); 
if (!ret) 
{ SetLine (NewObj (), leftPoint.x, leftPoint.y, 
rightPoint.x, rightPoint.y); 
nArcs++; 
first = true; 
leftPoint = rightPoint; 
Tl = T2; 
continue; } 
ret = TestDistance (Coeff0, Coeffl, Coeff2, Coeff3, 
Tl, TZ, Origo, Radius, Alpha, 
Deita, Eps); 
if ((ret = (ret &6& T2 '= Nodes ~ 1)) || first) 
origo = Origo, 
radius = Radius, 
alpha *= Alpha, 
delta = Delta, 
t2 = T2; 
if (ret} continue; 
SetArc (NewObj (), origo.x, origo.y, radius, alpha, delta); 
nArcst+; -- 
first = true; 
leftPoint = rightPoint; 
Tl = T2 = t2; 
} 
DelOb3 (id); 
DisposHandle {(Handle) Coeff0}; 
DisposHandle ({(Handle) Coeffl); 
DisposHandle ( (Handle) Coeff2); 
DisposHandle ((Handle) Coeff3); 


return nArcs; 
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LEAR RRR RERER AKER HERRERA REREK EAE AREA HEREC A KER REE REE KR / 


j* 7 
/* Mr. HORNER’s POLINOM = 
{* s/f 


[TERRE RARER ATE EERE RHE AEE KEKE EEK ERENT RR ERE EE / 


COORD Horner (8, a, b, ¢, ad) 


COHandle a, b, c, da; 
extended s; 


{ 


COORD q; 
extended t; 
int i; 


t = s - floor (s}; 

i= s; 

if (t == 0.0 &6& i) ie~, t = 1.0; 

q.x = (((*ati)->x*t + (*"btije>x) tt + (*eti)->x)p*t + (*dti) ->x; 
Q-¥ = (((*ati)->y*e + (*btijp]ery) *%t + (*etije>y) *t + (*dti)->y; 
return q; 
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/* « / 
/* CREATE AN ARC a / 
{* */ 


[RII TORII IO TOT TE TTT STOR IT TR RR IIR RR IR RR ERE REAR ERS / 


int CreateArc (leftPoint, middlePoint, rightPoint, 
Orige, Radius, Alpha, Delta) 


COORD leftPoint; 
COORD middlePoint; 
COORD rightPoint; 
COORD *Origo; 
extended *Radius; 
extended *Alpha; 
extended *Delta; 


extended dxl, dyl; 
extended adx2, dy2; 


extended vl, v2i 
extended det; 
extended ai; d2; 
extended $; 
extended phi, beta; 
Boolean change; 


dxl = middlePoint.x - leftPoint.x; 

dyl = middlePoint.y - leftPoint.y: 

ax2 = rightPoint.x - leftPoint.x:; 

dy2 = rightPoint.y - leftPoint.y? 

det = 4.0* (dxl*dy2 dadx2*dyl); 

if (fabs (det) < 0.000005) return false; 

vl = dxl* (middlePoint.x + leftPoint.x) + 
dy1l* (middlePoint.y + leftPoint.y); 

v2 = dx2*(rightPoint.x + leftPoint.x) + 
dy2*(rightPoint.y + leftPoint.y); 

dl = 2.0*{(vitdy2 - v2*dyl); 

a2 = 2.0*{v2*dxl - vi*dx2); 

Origo->x = dl/det; 

Origo->y = d2/det:; 
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*Alpha = atan2 (leftPoint.y - Origo->y, 


leftPoint.x - Origo->x) *RadToDeg; 
phi = atan2 (middlePoint.y ~ Origo->y, 

middlePoint.x - Origo->x)} *RadTobdeg; 
beta *= atan2 (rightPoint.y - Origo->y, 

rightPoint.x = Origo->x) *RadToDeg; 


*Radius= hypot (rightPoint.x - Origo->x, 
rightPoint.y - Origo->y); 
if (beta < *Alpha) s = beta, beta = *Alpha, *Alpha = s; 
if (*Alpha < 0.0) *Alpha += TotDeg; 
if (phi < 0.0) phi += TotDeg; 
if (beta < 0.0) beta += TotDeg; 
if (fabs (*Alpha - beta) < EpsDeg) 
change = (*Alpha - phi <= EpsDeg && phi - beta <= EpsDeg 
|| *Alpha - phi - TotDeg <= EpsDeg 6&6 
phi + TotDeg - beta <= EpsDeg 
|} *Alpha - phi + TotDeg <= EpsDeg &é 
Phi - TotDeg - beta <= EpsDeg 
|| beta -, Alpha > EpsDeg ? false : true); 
else if (*Alpha > beta) 
change = (beta < phi && phi < *Alpha || 
beta < phi + TotDeg && phi + TotDeg < *Alpha 
|| beta < phi - TotDeg && phi - TotDeg < 
*Alpha ? true : false); 
else 
change = (*Alpha <= phi && phi <= beta {| 
*Alpha <# phi + TotDeg && phi + TotDeg 
<= beta [| 
*Alpha <= phi ~ TotDeg && phi - TotDeg 
<= beta ? false : true); 
if (change) s = beta, beta = *Alpha,*Alpha = s - TotLeg; 
if (*Alpha < 0.0) *Alpha += TotDeg; 
*Delta = beta - *Alpha; 
if (*Delta < 0.0) *Delta += TotDeg; 
return true; 
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JI OID OITA I IORI OER ERIE RRR ARERR RR IRE E ® / 


/* « / 
/* CALCULATE THE DISTANCE BETWEEN ARC AND SPLINE x / _ 
/* «/ 


[RIOR RIOR IO IOI IOI SOTO STOR TORTOISE IIR IEE IEE R REE RE IRR / 


int TestDistance (Coeff0, Coeffl, Coeff2, Coeff3, — 
tBeg, tEnd, Origo, Radius, Alpha, Deita, Eps) 


COHandle Coeff0; 

COHandle Coeffl; 

COHandle Coeff2; 

COHandle Coeff3; 

extended t85eg; 

extended tEnd: 

COORD Origo; 

extended Radius; 

extended Alpha; 

extended Delta; 

extended Eps; 

{ 
int i, mn, ii, reverse; 
extended area, angle, t; ths 
COORD points [2*PREC+1], arch, arce, spline; 


n = 1.0/Eps; 
if (n > PREC) n ® PREC; A 


spline = Horner (tBeg, Coeff3, Coeffe, Coeffl, Coefft0); 
arcb.x * Origo.x + Radius*cos (Alpha/RadTobeg) ; 
arcb.y = Origo.y + Radius*sin (Alpha/RadTobeg) ; 
arce.x = Origo.x + Radius*cos((Alpha+tDelta) /RadTobeg) ; 
arce.y = Origo.y + Radius*sin((Alpha+Delta) /RadToDeg) ; 


reverse = hypot (spline.x-arcb.x, spline.y-arcb.y) < 
hypot (spline.x-arce.x, spline.y-arce.y); 


for {i = 0; i <*® n; itt) 
angle = (Alphat+i*Delta/n)/RadTobeg, * 
points [i].x = Origo.x + Radius*cos(angle), 
points [i].y = Origo.y + Radius*sin(angle), 
t = tBeg + i*{tEnd - tBeg)/n, 
ii = reverse ? 2*n - 1 n+ii, 
points [ii] = Horner (t, Coeff3, Coeff2, Coeffl, Coeff): 
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for (i = 1; i < n; itt) 
if (hypot (points[i].x-points[2*n-i) .x, 
points{i} .y-points[2*n-i].y) > 1.0) 
return false; 


for (i = 0, area = 0.0; i < 2*n; i++) 
Zi = i we 2*n -~ 170: 3+ 1, 
area +™ (points[ii].x - points[i].x) * 
(points[(ii].y + points[i].y); 


t = Delta/RadTobeg*Radius; 
return fabs (area)/2.0/t < Eps; 
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Command index 


A 


ABEGIN 131 

ABORT 17 
ACCUMULATED 141 
ADDSYMB 113 
ADIGITS 124 
ADIVIDED 142 
ADJUST 82 

ADJUST FIRST 82 
ADJUST SELECT 82 
AEND 131 

AGRAPHIC 144 
AINTERSECTION 143 
ALL 156 
AMINTERSECTION 143 
AND 157 

ANGLE 130 
APARALLEL 142 
APERPENDICULAR 142 
AROTATED 142 
ASNAP 117 
ASTRUCTURED 143 
ATEXT 130 
ATTRIBUTES 132 
ATTRIBUTES DEFAULT 132 
AUNIT 117 
AUTONUMBER 89 
AUTOSAVE 118 
AUTOSCALE 21 
AXFORM 131 


B 


BEGIN 157 

BEVEL 36 
BOTTOMLEFT 137 
BOX ROTATION 152 
BOX ROTOTRANS 153 
BOX XLATE 150 

BOX XSCALE 151 
BREAK 194 
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Cc 


CALL 197 _ 
CANCEL 17 

CARC 53 

CARC BITANGENT 54 

CARC CPOINT 54 

CARC P3 53 

CATALOGUE 110, 111 

CATALOGUE SYMBOL 111 

CCURVE [SMOOTH] 55 

CCURVE CONTIGUOUS 56 a 
CDISTANCE 137 

CDIVIDED 136 

CENTER 133 

CFONT 121 — 
CGAP 120 

CHAIN 155 

CHEIGHT 120 

CIRCLE 48 as 
CIRCLE BITANGENT 50 

CIRCLE CPOINT 48 

CIRCLE CTANGENT 49 

CIRCLE P2TANGENT 51 

CIRCLE P3 50 

CIRCLE PBITANGENT 51 

CIRCLE TRITANGENT 52 

CLOSE 109 

CLOSEFILE 115 sa 
COLOR 118 

COMPLEMENT 83 

COMPRESS 16 

CONCATENATED 145 

CONSTLINE 37 

CONSTLINE BITANGENT 44 

CONSTLINE DFPOINT 41 

CONSTLINE DFTANGENT 42 

CONSTLINE DPARALLEL 39 

CONSTLINE PARALLEL 38 

CONSTLINE PERPENDICULAR 40 

CONSTLINE PTANGENT 45 

CONSTLINE TANGENT 43 ~ 
CONTINUE 194 

CRTICENTER 137 


CSLANT 121 

CUTTING 81 

CUTTING FIRST 81 
CUTTING SECTION 81 
CUTTING { ALL ! HERE } 82 
CWIDTH 120 

CXFORMED 136 

CXLATED 136 

CXPOLAR 136 


D 


DAFORMAT 126 
DATOLERANCE 127 
DEFATTRIBUTES 132 
DELETE 80 
DELETE ALL 80 
DELETE PART 80 
DELETE SELECT 80 
DFORMAT 126 
DIALOG 179 
DIGITS 124 
DIMARRAY 179 
DIMENSION 

{ AX | AY | CAX | CAY } 72 
DIMENSION 

{ DANGLE | CANGLE } 71 
DIMENSION 

{ DISTANCE | DISX | DISY } 70 
DIMENSION 

{ DISX | DISY } { SERIAL | 

CUMULATIVE | PARALLEL | 

_PROGRESSIVE } 76 

DIMENSION [ {LI LX i LY} ] 69 
DIMENSION ARROW 75 
DIMENSION DEXTERNAL 75 
DIMENSION DFIX 74 
DIMENSION DIAMETER 74 
DIMENSION DRADIUS 73 
DIMENSION PARALLEL 72 
DIMENSION RINTERNAL 73 
DO 193 
DPOINT 28 
DPOLAR 135 
DSCALE 124 


DTCOLOR 127 

DTLWIDTH 128 
DTOLERANCE 127 

DUMMY 17 

DUPLICATE 91 

DUPLICATE CONTINUOUS 93 
DUPLICATE PART 92 
DUPLICATE SELECT 91 

{Dx] 135 

[DY} 135 


E 


EARC 59 

EARC FPOINT 59 
EDIT 85 

EDIT EFILE 16 
ELLIPSE 57 

ELLIPSE FDISTANCE 57 
ELLIPSE FPOINT 58 
ENTER 17, 160 
ERASE 111 

ERASE SYMBOL 111 
ERROR 194 
EXCEPT 157 
EXISTING 146 

EXIT 194 
EXTREMUM 133 


F 


FILLET 55 
FOCUS 134 
FOLDER 113 
FOLLOWING 22 
FONTDEF 115 
FOR 192 
FSPECIAL 128 
FTEXT 129 
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G 


GLOBAL 132 
GRID 26 


H 


HATCH 63 

HATCH CHAIN 65 
HATCH INTCHAIN 67 
HDIRECTION 123 
HOFFSETF 122 

MSTEP 123 


! 


IDENT 154 

IF 189 

INTCHAIN 156 
INTERSECTION 134 


J 


JOURNAL 178 
JUSTIFY 122 


L 


LAYER 23 

LDISTANCE 140 
LGAP 121 

LIKE 178 

LINE 29 

LINE AXIS 35 

LINE AXIS HV 35 

LINE BITANGENT 33 
LINE HORIZONTAL 31 
LINE HV 32 

LINE PERPENDICULAR 30 


Command index 


LINE PTANGENT 34 
LINE SINGLE 30 
LINE SINGLE HV 33 
LINE VERTICAL 31 
LIST 115 

LISTFILE 115 
LRATIO 149 
LSCALED 140 
LTYPE 119 
LWIDTH 119 
LXFORM 131 


M 


MAJOR 130 

MATRIX 154 

MDISTANCE 137 

MERGE 109 

MIDDLE 134 

MINOR 131 

MINTERSECTION 135 

MIRROR 148 

MIRROR ITEM 148 

MKIND 125 

MODIFY 89 

MODIFY POLYLINE SLICE 87 

MODIFY POLYLINE SMOOTH 86 

MODIFY { POLYLINE | SPLINE } 
ADDNODE 8&5 

MODIFY { POLYLINE | SPLINE } 
DELNODE 85 : 

MODIFY { POLYLINE | SPLINE } 
DELPART 86 

MODIFY { POLYLINE ! SPLINE } 
MOVENODE 86 

MODIFY CONNECT 86 

MODIFY DAUNIT 8&3 

MODIFY DIMENSION 84 

MODIFY ENDPOINT 83 

MODIFY GROUP 90 

MODIFY LENCTH 83 

MODIFY NLENCTH 84 

MODIFY PDIMENSION 84 

MODIFY SPLINE 87 

MODIFY SPLINE ROUGH 87 


MODIFY SYMBNPAR 88 
MODIFY SYMBPAR 88 
MODIFY TEXT 85 

MOVE 91 

MOVE CONTINUOUS 93 
MOVE PART 92 

MOVE SELECT 91 

MSIZE 125 

MULTILINE 145 
MULTJTRANS 154 


N 


NC 99 

NC CHAIN 101 

NC INTCHAIN 102 
NC OPENCHAIN 100 
NEAREST 136 

NEW 15 

NODES 123 


O 


OFFSET 95 

OFFSET CHAIN 97 
OFFSET INTCHAIN 98 
OFFSET OPENCHAIN 96 
OPEN 109 
OPENCHAIN 156 
OPENPRINT 113 
OPENSCAN 114 
ORIGO 137 


P 


PAN 21 

PARS 198 
PDELETE 81 
PEN 25 
PERIMETER 139 
PLOT 27 
POINT 28 


POLAR 135 

POLYGON 46 
POLYGON REGULAR 47 
POLYLINE 46 

POSITION DRAW 110 
POSITION SYMBOL 110 
PRECISION 123 
PREVIOUS 22 

PRINT 27 

PRINTF 114 

PROJLINE 128 

PURGE 112 


Q 


QUIT 15 


R 


RADIUS 130 
RATIO 22 
RECTANCLE 47 
REDRAW 22 
REDUCED 141 
RENAME 112 
RENAME SYMBOL 112 
REPEAT 131 
RESOLVE 113 
RETURN 197 
RGB 24 
ROTATION 147 
ROTOTRANS 148 


S 


SAVE 108 

SCALE 20 

SCANF 114 

SCARC 161 

SCIRCLE 161 

SCOLOR [SELECT] 158 
SCOLOR NSELECT 158 
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SCREENSAVE 116 
SDIMENSION 161 
SEARC 161 

SEARCHLIB 110 
SELLIPSE 161 

SHATCH 161 

SHOW 22 

SITEM 161 

SIZE 140 

SLAYER ACTIVE 157 
SLAYER NSELECT 158 
SLAYER SELECT 158 
SLINE 161 

SLTYPE [SELECT] 158 
SLTYPE NSELECT 159 
SLWIDTH [SELECT] 159 
SLWIDTH tNTERVAL 159 
SLWIDTH INTERVAL NSELECT 159 
SLWIDTH NSELECT 159 
SNAME 157 

SNAP 117 

SPLINE [OPENED] 60 
SPLINE ANTICYCLIC 61 
SPLINE CYCLIC 60 
SPOINT 161 
SPOLYLINE 7161 
SSPLINE coord 161 
SSYMBOL 161 

STEXT 161 

STRETCH 94 

SUBTEXT 146 
SWINDOW FRAME 155 
SWINDOW IN 155 
SWINDOW OUT 155 
SWITCH 190 
SYMBDEF 78 
SYMBHATCH 64 
SYMBHATCH CHAIN 66 
SYMBHATCH INTCHAIN 68 
SYMBNPAR 129, 130 
SYMBPAR 129 
SYMBTEXT 130 
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tf 


TDATE 146 
TDIRECTION 121 
TEXT 62 

TFILE 146 
TLAYER 128 
TOLERANCE 116 
TOPRIGHT 137 
TORIGIN 122 
TREPEAT 145 
TTIME 146 


U 


ULINETYPE 120 

UNDO BACKWARD 90 
UNDO FORWARD 930 
UNDO { ON | OFF } 90 
UNIT 116 

UNLINK 112 

UNLINK SELECT 112 

USE 138, 141, 144, 146, 154 
USERPROC 198 


V 


VANGLE 174, 180, 182, 184, 185 
VCOORDINATE 175 

VFLOAT 173, 180, 182, 184, 185 
VINTEGER 172, 180, 182, 184, 185 
VLENGTH 174, 180, 182, 184, 185 
VTEXT 178, 186, 187 

VXFORM 177 


W 


WAIT 16 
WHILE 193 
WINDOW 20 


x 


{x] 135 

XC 141 

XLATE 147 

XLATE XPOLAR 147 
XLATE XY 147 
XSCALE 149 
XSCALE {X1Y¥} 149 


Y 


[Y] 135 
YC 141 


Z 


ZOOM [IN} 18 
ZOOM OUT 19 


7 


PACTUAL 105 
2?ANGLE 104 
?7ATTRIBUTES 105 
?COORDINATE 103 
?DISTANCE 103 
(GRID 104 
7HATCH 106 
7ITEM 103 
‘LAYER 106 
?7LENGTH 104 
7MENU 106 
?2SNAP 106 
?SPACE 106 
?SYMBOL 107 
?TOLERANCE 107 
7UNDO 106 
?VARTAB 107 
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